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SECTION I 



GENERAL DESCRIPTION 



AN AID TO 
OPERATORS 



AN AID TO 
PROGRAMMERS 



32KSYS. an operating system for Phxlco 2000 computers 
with 32, 768 words of core storage, .s an assembly of 
executive routines designed to provide efficient use of 
computer run time by standardizing operarng procedure? 
and by reducing the necessity for operator mtervenUor. 

32KSYS relieves the operator from manually performing 
such functions as program loading, rewinding tapes and 
enacting post mortem dumps it also minimizes the 
amount of tape moun*-rg and ds mounting between JOBS 
by providing a symbolic tape assignment fac iity 

32KSYS provides many specialized routires to aid the 
programmer in running and debugging programs. More 
over, 32KSYS Entries, or internal subroutines, may be 
used to reduce such programmer tasks as repeating 
numerous instructions to the operator, or calling external 
subroutines. 



AN AID TO 
OPERATIONS 



Additional time saving for computer centers is gained as 
32KSYS can accept in succession any type of source 
language program (-he, , TAC or ALTAC) to be compiled 
and run. 32KSYS also provides memory dumps or snap 
shots in the event of program failure „ 

32KSYS reduces tape handling time by permitting input 
programs to be stacked (placed -.n consecutive order) 
on the same tape prior to compilation or running. Sim.lar 
ly, object programs (those which have been compiled) and 
edited outputs can be stacked on their respective outpui 
tapes „ 
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GENERAL 32KSYS OPERATIONS 



32KSYS is on magnetic tape during the compilation or 
running of a program. Most of its operations are also 
contained within memory at all times to direct the oper- 
ation of programs. As other sections of 32KSYS (not 
memory contained, because of infrequent use) are re- 
quired, they are read as three -block-length routines into 
memory from tape and executed. 32KSYS requires 4096 
words of memory (locations zero through 7777„ ), leaving 
the remainder of the 32, 768 words of memory to the 
programmer's use. 



32KSYS TAPE 

ASSIGNMENT 



32KSYS contains a symbolic tape -assignment facility 
(see Section l*.) . Tapes may be mounted on any available 
transport However- in order that 32KSYS operate at 
maximum efficiency, the system tape must be assigned 
unit 1. and the intermediate dump tape must be assigned 
unit 2„ 



COMMUNICATION 
WITH 32KSYS 



Communication between 32KSYS and the programmer may 
be made by Control Lines, 32KSYS Entries, 32KSYS 
Service Routines. Compters, and TAC Library Routines 
for 32KSYS = 



Control Lines 



Control Lines are written by the programmer in standard 
TAC instruction format and are submitted from outside a 
user's program, Each control line consists of a control 
instruction and its parameters, and causes actions such 
as. 



reading wr'ting, or rewinding tapes 

loading programs into memory and transferring 
control to them 

stopping computer action or transferring control 
to a location in memory 

signifying the types of debugging memory dumps 
desired. 
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32KSYS Entries 



32KSYS Entries permit the programmer to call various 
routines stored within the b ri sic operations of 32KSYS. 
The programmer may call ;hese routines by writing a 
transfer of control from his program to a desired entry. 
Each entry is a location within 32KSYS which transfers 
control to its respective routine. The actual locations 
of these entries within 32KSYS are defined by preset 
symbol definitions in TAC. 

The entries include provisions for such operations as: 

• post-mortem dumps 

• Console Typewriter type -outs 

• reading, writing, and rewinding tapes 

• scanning routines for the Address and Remarks 
field of a TAC-format card. 



Service 
Routines 



Library 
Routines 



32KSYS Service Routines are generally called by writing 
a control line that designates the service routine as one 
of its parameters . These routines are specialized 
programs designed to aid the programmer in performing 
routine functions of tape maintenance, debugging, and 
program monitoring. 

Library Routines include special subroutines and gener- 
ators applicable to programs run under 32KSYS control. 
These are called by the programmer in the same manner 
as any TAC subroutine or generator. 



32KSYS CONVENTIONS 



MEMORY 
CONCEPT 



SENTINEL WORD 



The following conventions, definitions, and special 32KSYS 
symbols are used throughout the manual. 

The beginning of memory is referred to as Location Zero, 
while the high-order locations are referred to as the end 
of memory, 

8 or fewer alphanumeric characters, excluding break 
characters. Spaces are ignored. If fewer than eight 
characters are used, the sentinel word will be right 
justified and left-filled with zeros. 



1-3 



SENTINEL BLOCK 



A block of 128 identical words, Only the first 120 words 
of the block are inspected by 32KSYS. however, during a 
sentinel search. Break characters are never included in 

the configuration of a sentinel block produced by the sys- 
tem. 



OPTIONAL 
PARAMETER 



Optional parameters must be indicated by the presence 
of a break character, unless otherwise noted 



BREAK 
CHARACTER 



ILLEGAL 
CHARACTER 



PROGRAM 

inTTMTITV 'ID^ 

1J^> 1—i A 1 J- J. J- J. \ Xi-r / 



One of lour designated characters .s used to separate 
parameters within 32KSYS control lines it may be a 
comma (), period (.). semicolon ( ,), or slash ( /) . No 
distinction is made between these break characters 
except where otherwise noted in this manual. 


The special Phiico character e (Hollerith code 7) is an 
illegal character when entered via a 32KSYS control line 
parameter 

Sixteen or fewer alphanumeric charac ters used as a 

r,r-if 



uni n us c ont i sur at *on to tabel 
signixicani. 



— r— "~ - 

j-/oaoing 



Functions 



CODE MODE 



The format resulting from the card-to-tape conversion 
of cards punched in Hollerith code into Phiico 2000 Code 
by the Punched Card Controller- if Code Mode is indi- 
cated, 32KSYS assumes that data has been converted to 
Code Mode 10 words per card. 12 cards per block. 
(Refer to Phiico Codes, Appendix B, ) 



HOLLERITH -CODE 
MODE 



The same as Code Mode 



IMAGE MODE 



The format resulting from the card-to-tape process that 
transcribes the twelve rows of each column of a card as 
12 binary digits onto tape- Punches are transcribed as 
ones. If Image Mode is indicated, 32 KSYS assumes that 
data has been transcribed in Image Mode, 20 words per 
card, six cards per block. Image Mode format may be 
in either Hollerith-Image Mode or Binary-Image Mode. 



HOLLERITH-IMAGE 
MODE 



The format resulting from Image Mode processing of 
cards punched in Hollerith code 
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BINARY - 
IMAGE MODE 



ADDRESS 



The format resulting from image Mode processing of 
cards punched in binary form Binary cards may be 
read only in Image Mode. 

The symbols used in the description of control instruc- 
tion parameters that call for an address, are indicative 
of the form in which they are to be supplied, Three 
symbols are used: 



m 



an octal number from 10000 to 77777, 



loc an octal number from 10000 to 77777: or an octal 

number from to 67777 suffixed by a P, indicating 
the locat'.on s relative *o a program origin, or an 
octal number from to 67777 suffixed by a C 
indicating the location is relat.ve to common. 

addr an octal number from 10000 to 77777. or an octal 

number from to 67777 suffixed by a P, indicating 
the locat.on is relative to a program origin, or an 
octal number from to 67777 suffixed by a C , 
indicating the location is relative to common, or 
a symbol in the form NAME, FLAD 

addr may be augmented by ±n or ±nH, where n :s 
a decimal number 



DUMP 



A dump is edited information from designated memory 
locations which is subsequently transmitted onto magnetic 
tape for off-line punting on the High-Speed Printer , 



POST-MORTEM 
DUMP 



A post-mortem dump is a dump which occurs when con- 
trol is transferred to the J2KSYS entry 1 ZERO, 
1ERRDMP, or 1SUBERR, The dump is specified by the 
DUMP control instruction 






SYMBOLIC TAPE 



A snapshot dump is a dump which occurs at designated 
locations during the running of an object program, as 
specified by the SNAP control instruction 

The tape which is defined by a symbolic tape name (refer 
to Symbolic Tapes) or a system program unit number, 
or a program unit number which has been previously def mec 
by a TAPES instruction 
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PRESET SYMBOLS 
IN TAC 



The following is a list of preset TAC symbols: 



SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS C 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 
SYS. 



1ZERO 

1SYSIN 

1ERRDMP 

1ENDJOB 

1NXTCON 

1TYPOUT 

1 ENCODE 

1CLOCK 

1MEMSIZ 

1SCANBL 

1GETBL 

1IGBL 

1SCAN 

1SCANON 

1STRIPQ 

1XCONER 

1NXTCRD 

1INTLD 

1SYSRET 

1ADCONI 

1ADCONC 

1INTCMD 

1TAPENO 

1XECUTI 

11NTCON 

1PUNSYM 

1PRTCON 

1PRTMSG 

1SYSHLT 



SYS. 1PRTRUN 

SYS.1XORD 

SYS.1SPORD 

SYS.1SETXRD 

SYS.1CHKORD 

SYS.1MXORD 

SYS.1COMPER 

SYS.lXtAPE 

SYS.1NTRYJA 

SYS.1START 

SYS. 1CONBIT 

SYS, 1CHARCT 

SYS. 11BIT 

SYS.1SYSOPS 

SYS. 1CONLIN 

SYS. 1 DATE 

SYS. 1BRKSTR 

SYS. 1WRD1 

SYS. 1WRD2 

SYS. 1CLORD 

XORD. XORD 

SPORD.SPORD 

SETXORD. SETXORD 

CHKORD.CHKORD 

MXORD.MXORD 

XTAPE.XTAPE 

CLORD.CLORD 

SYS. 1MSGCON 
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SECTION II 



SYMBOLIC TAPES 



INTRODUCTION 



Tape assignment is that procedure whereby a particular 
reel of tape is connected in some manner with a particu- 
lar tape unit in preparation for input -output processing 
of the reel. In general, there are two methods of as- 
signing tapes for a job. 



The first method requires the programmer to pre -deter 
mine the connection of reels and units and to specify this 
connection to the operator. This method has proven to 
be prohibitive because often two independent successive 
jobs require different file tapes on the same logical tape 
unit. To prevent the delay associated with rewinding and 
dismounting the previous file tape and then mounting the 
required file tape, operators usually mount the second 
file tape on a different (unused) unit and when the file 
tape is needed, replug the logical/physical connection. 



SYMBOLIC TAPE 
NAMES 



The second method enables the operator to mount the 
file tape on any unit and to communicate the assignment 
to the program. This is the technique implemented in 
32KSYS. It requires little, if any, replugging of logical/ 
physical connections to provide tape assignment. It does 
require the use of symbolic tape names. 

A symbolic tape name is a collection of seven or fewer 
characters, one of which must be non-numeric, which 
uniquely identifies a tape reel for a particular job. 
Several special character sets are excluded from use 
within an object program. 



These are the System symbolic tape names: 



TSYSTEM 

TSYSDMP 

TSYSOUT 

TSYSLIB 

TSYSIN 



TSYSCRO 
TSYSCR3 
TSYSCR4 
TSYSCR6 
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OPERATOR 

ACTION 



At some point during the running of each job the operator 
must communicate to 32KSYS the logical unit number of 
each significant reel of tape. (A detailed description of 
operator action is given in Operating Procedures, Appen- 
dix A. ) 



USE OF 
SYMBOLIC 
TAPE NAMES 



Symbolic tape names should be used whenever a tape 
parameter is specified, either in a system control in- 
struction, or in an object program Since the 32KSYS 
input-output processor. XORD, requires a number (PUN, 
or program unit number) in every order specifying 
the reel to be processed, symbolic tape names must be 
assigned to PUN's. 



EXTERNAL 
ASSIGNME NT 



There are two methods of assigning a symbolic name to 
a PUN external and internal. The external method im- 
plies that the PUN ultimately appearing in the input -output 
order has been selected externally, and has not been pre- 
determined by the programmer. The internal method im- 
plies that the PUN appearing in the order has been pre- 
determined by the programmer. 

The external method requires that the object program per- 
form certain functions during its execution. These are: 

• Given a symbolic name for a tape, ask for a PUN to 
be associated with this name via the SYS subroutine 

1 TAPENO, 

• Insert the PUN into the input -output order. 

• Execute the order. 



The symbolic 'ape name is either a program parameter 
i. ompiied with the program, entered as data, or gener- 
ated. This name must correspond to a unique reel of 
tape during the running of the program. It is not desira- 
ble to specify a specific reel number at compile time; 
therefore, if the tape name is compiled with the program, 
this name is usually a functional designation, e.g., an 
input tape might he designated as INPUT. The specific 
reel identification is then associated with this symbolic 
tape name by ihe use of the TAPES control instruction at 
job time. For example, let the desired input tape be reel 
number 1 02 34= Then, execution of the following control 
instruction wilJ relate INPUT to 1-0234: 



TAPES 



1-0234, INPUT 



2-2 



INTERNAL 
ASSIGNMENT 



This method has the advantage that if the input reel num- 
ber is different on the next execution of the object pro- 
gram, only the TAPES control instruction card need be 
changed. 

The internal method requires that the PUN in an input - 
output order of a program be defined at compile time. 
When a program is written, a pre -determined PUN is 
placed in the input-output order, either directly, or sym- 
bolically (if a symbol, it must be defined with an ASGN 
card). The TAPES control card is used to relate the reel 
identification with the PUN. As an example, let the PUN 
chosen be 9, and let the reel identification of the tape used 
be 1-0234; then, execution of the following control instruc- 
tion, prior to the running of the object program, will make 
the proper association. 



TAPES 



1-0234,9 



PUN'S 
PERMITTED 



The PUN' s permitted to the user are the numbers 
through 15. Numbers through 8 refer to specific sys- 
tem tapes, and if used will refer to the system tape des- 
ignated in the following table: 



SYS PUN'S 



PUN 



System Symbolic Tape Name 






^TSYSCRO 


(scratch tape) 


1 


TSYSTEM 


(system tape) 


2 


TSYSDMP 


(scratch tape) 


3 


L--TSYSCR3 


(scratch tape) 


4 


^PSYSCR4 


(scratch tape) 


5 


TSYSOUT 


(system output tape) 


6 


<UPSYSCR6 


(scratch tape) 


7 


TSYSL1B 


(system library tape) 


8 


TSYSIN 


(system input tape) 



RULE 



The following rule must be observed: Any reference 
(via 32KXORD, or a 32KSYS Tape Handling function) to a 
PUN greater than 8 must be related to a symbolic tape 
name by a TAPES control instruction. 



Control will be returned to the system via 1XCONER if 
the above rule is violated. 



2 = 3 



TAPES 



FUNCTION 



Relates a tape name (reel number) written on the jod 
sheet to the tape name used by the program. 



FORMAT 



PARAMETERS 



ACTION 



RESTRICTIONS 



L 


Location 


Command 


Address and Remarks 


H 




TAPES 


par 1 (W), par 2 



par 1 - The symbolic tape name (e,g,, a reel number 
"or system symbolic tape name) written on the job 
sheet to identify the tape reel to be mounted by 
the operator. 

(W) (OPTIONAL) - Indicates thai par 1 is an output tape 
and must be write enabled, 

par 2 (OPTIONAL) - The symbolic tape name or program 
unit number by which subsequent programs refer to 
the tape reel identified by par, 1. 

H (OPTIONAL) - Indicates that par 1 is to be held for 
the next job (refer to iENDJOB), 

The tape tables within 32KSYS are updated to relate par 1 
to par 2„ 

1, If par 2 is a program unit number, it must be 9 thru 
15 and this must be the f.rst appearance of par 1 
within the job. 

2. If par 2 is a symbolic tape name, this must be its 
f\rst appearance within the job 



REMARKS 



The TAPES control instruction pertains to the cur- 
rent job only. 



par 1 is typed on the console typewriter by 32KSYS 
for tape assignment by the operator (refer to 
Operating Procedures), 

The (W) parameter enables 32KSYS to distinguish 
between legal and illegal write orders to a tape that 
is not write enabled. However, 32KSYS does not 
distinguish between legal and illegal write orders 
to a tape that is write enabled. 



If par 2 is omitted, subsequent programs may refer 
to the tape reel by par 1 . 



RELEASE 



FUNCTION 



Releases a symbolic tape name from its assignment. 



FORMAT 



L 


Location 


Command 


Address and Remarks 






RELEASE 


Jq • " "$-2 



PARAMETERS 
ACTION 



REMARKS 



t_i, . . ,t£ = Symbolic tape names, only. 

Execution of the RELEASE control instruction initiates 
the following action: 

e The tape name(s) specified are released from their 
specific assignments by removing the name(s) from 
the tape name list. 

• The tape(s) associated with the tape name(s) released 
may or may not be rewound with lockout. A tape is 
rewound with lockout if the released tape name was 
the only reference to the tape. 

1. Any tape name not in the tape name list will be ig- 
nored. 

2. System tape names will be ignored. 

3. A numeric designation will result in a control line 
error. 
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SECTION III 
SYSTEM TAPES 



Normal 32KSYS use requires nine 
magnetic tape units which the oper- 
ator assigns to the following sym- 
bolic tape names when needed. 
(Refer to Operating Procedures, 
Appendix A. ) 
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TSYSTEM 



TSYSTEM - System Program Tape 



FUNCTION TSYSTEM is the System Program Tape, containing 

32KSYS in image form and System Routines, e.g. , 
TAC, RPLC, TACSERV, COBOL, etc. , in RPL 
form. 
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TSYSpMI 



TSYSDMP - System Scratch Tape 



FUNCTION 



TSYDMP is a System Scratch Tape used by: 



• 32KSYS as an intermediate tape for dumps 
and snaps. 

• TAC, ALTAC, COBOL, REPORT GENERATOR, 
and ALTAC3X as a scratch tape. 



REMARKS 



TSYSDMP is rewound when a JOB control instruction 
is encountered. 



TSYSIN 



TSYSIN - System Input Tape 



FUNCTION 



REMARKS 



The System Input Tape contains 32KSYS control 






/ 1 n 
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12 cards per block) or Image Mode (20 words per card, 
6 cards per block)- 

If desired, a special mixed image/code format may be 
used. A mixed mode System Input Tape is constrained 
as follows: 



The two indicator cards, IMGEIMGE and 
CODECODE, specify the mode of the card 
immediately following the indicator card. 

All JOB cards, IMGEIMGE cards, and 
CODECODE cards must be on tape in code 
mode. 

The JOB card must contain JOBAAAAA in the 
command field. 

No restriction is placed on the positioning within 
a block of an image mode card except no image 
mode card may straddle a physical block. There 
fore, an IMGEIMGE card must be used to fill the 
last 10-word item of a block when the crossover 
would occur. 



The JOB card, in addition to its normal functions, 
also performs the same function as the 
CODECODE indicator card. Therefore, cards 
immediately following the JOB card are assumed 
to be in code mode until an IMGEIMGE card is 
encountered. 



TSYSOUT 



FUNCTION 



TSYSOUT - System Output Tape 

TSYSOUT is the System Output Tape on which informa- 
tion ia placed for off-line printing and punching. To 
use the tape, however, the programmer must adhere 
to the 32KSYS standards concerning the four modes of 
Data Select described below under FORMAT. 

It is used by 32KSYS to print: 

• Information to identify jobs. 

e All executed control instructions. 



FORMAT 



Data Select 



Data Select 1 



• Error information. 

• Dumps and Snaps. 

It is used by all compilers to: 

• Punch binary card images. 

• Print edited output. 

The format of the various types of 32KSYS output, 
specified by the particular Data Select mode, is 
described as follows: 

Data Select is used to identify blocks to be printed 
on the High-Speed Printer. The standard print plug- 
board setting is one-to-one. 

Data Select 1 is used to identify blocks for binary 
card punching in Image Mode (20 words per card, 
6 cards per block), with the Control Character SENSE/ 
IGNORE Switch of the Punched Card Controller set to 
IGNORE when these cards are punched. To aid oper- 
ators in separating binary decks and associating them 
with other output from the various jobs, 32KSYS pre- 
cedes each distinct deck with one card in which all 
rows of Columns 1 through 8 are punched. For the 
convenience of operators, any programs using the off- 
line punch features of TSYSOUT should state via the 
Console Typewriter the number and type of cards to be 
punched. 
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TSYSOUT 



i/aia oeteci t. 



±j<nitt jeicti 



Data Select 3 



card punching in Code Mode (10 words per card, 12 
cards per block), with the Control Character SENSE/ 
IGNORE Switch of the Punched Card Controller set to 
IGNORE when these cards are punched. As mentioned 
previously, any program using the off-line punch 
features of TSYSOUT should state via the Console Type 
writer the number and type of cards to be punched. 

Data Select 3 is used to identify blocks containing JOB 
accounting cards in Code Mode (10 words per card, 
12 cards per block). These cards contain the same 
JOB accounting information as appears in Data Select 
0, if an accounting clock is in the system. 



Data Select 4 



Data Select 4 is used to identify blocks containing data 
for the X - Y Plotter. 



WRAPUP 



Whenever the Wrapup function of 32KSYS is used by an 
operator, the following is written on TSYSOUT. 



End -of -tape sentinels with unconditional stops in 
each of the following Data Select modes used by 



In Data Select 0, this statement, edited for 
the High-Speed Printer, appears several 
times: 

THIS IS THE END OF THE TAPE STOP 
PRINTING 

It is followed by a page -eject. 

In Data Select 1, a block of filler 
characters (Octal 32) is edited for 
punching. 

In Data Select 2, ten words are edited to 
punch a Hollerith -Image card with the first 
and last rows of all columns punched. 

In Data Select 3, a block of filler characters 
(Octal 32) is edited for punching. 
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TSYSOUT 



5. In Data Select 4, the following operations 
for the X - Y Plotter are performed: 

a. The pen is raised and positioned 0. 5 
inches toward the top of the paper, and 
is then positioned at the left margin. 

b. The pen is lowered and a saw-toothed 
pattern with a 45° diagonal length of 
1.12 inches is drawn from left to right. 

c. The pen is raised and positioned 1. 26 
inches above the saw -toothed pattern. 

• A sentinel block of Z's is then written, and the 

tape is rewound with lockout. 

END OF TAPE Whenever end of tape is sensed, the tape assigned to 

TSYSOUT is rewound with lockout and a new assign- 
ment requested for TSYSOUT. 



TSYSLIB 



TSYSLIB - TAC Library Tape 



FUNCTION TSYSLIB is the normal TAC Library Tape. 

Subroutines should be in relocatable binary format 
because the tape is automatically searched by 32KSYS 
when a REL. . . .SUBS call is encountered. 

In general, TSYSLIB contains the various macro- 
instructions, generators, and relocatable binary sub- 
routines that are available to the programmer. 
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TSYSCRO 



TSYSCRO - System Scratch Tape 



FUNCTION TSYSCRO is used as a scratch tape by TAC, 

COBOL, REPORT GENERATOR. ALTAC, and 
ALTAC3X. 

REMARKS TSYSCRO cannot be assumed to be in a rewound 

position. 
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TSYSCR3 



TSYSCR3 - System Scratch Tape 



FUNCTION TSYSCR3 is used as a scratch tape by i/\^ 3 ludul, 

REPORT GENERATOR, ALTAC and ALTAC3X. 

REMARKS TSYSCR3 cannot be assumed to be in a rewound 

position. 
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TSYSCR4 



TSYSCR4 - System Scratch Tape 

FUNCTION TSYSCR4 is a System Scratch Tape used by: 

• TAC as a machine language output tape unless 
a PROGTAPE control instruction preceded the 
TAC control instruction. 

• ALTAC - same as TAC. 

• COBOL as a positioned scratch tape, (TSYSCR4 

is repositioned when the COBOL phase is finished) 
and as a machine language output tape unless a 
PROGTAPE control instruction preceded the TAC 
control instruction. 

• Report Generator - same as COBOL. 
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TSYSCR6 



TSYSCR6 - System Scratch Tape 



FUNCTION 



TSYSCR6 is used as a scratch tape by TAG, COBOL, 
REPORT GENERATOR, ALTAC, ALTAC3X and 
ANALYZER. 



REMARKS 



TSYSCR6 cannot be assumed to be in a rewound 
position. 
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SECTION IV 



32KSYS XORD 



FUNCTION 



32KSYS XORD, the 32KSYS input-output subroutine, 
provides a simple means of issuing read, write, space, 
and rewind orders. 



FEATURES 



The following are some of the features of XORD: 



• The XORD subroutine is contained within memory 
at all times. 

• 32KSYS and the 32KSYS programmer use XORD 
to execute magnetic tape orders. 

• Single and multi-block read, write, and space 
orders can be issued. 

• Rewind and rewind-with-lockout orders can be 
issued. 

• Order checking is automatic. For example, 
issuing a tape order causes automatic checking 
of any outstanding order for the unit. 

• in many instances, job restarts or cancellations 
are eliminated. For example, if a unit is in 
local, XORD allows the operator to put the unit 
in remote and continue the program. 

• In many cases, successive orders for the same 
tape are executed before tape movement stops. 

• Normal use of XORD results in the order being 
processed by the Input-Output Processor (IOP) 
when the exit occurs. 
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ENTRANCES 
TO XORD 



CHECKING 
ORDERS 



The subroutine XORD has the following entrances: 

• MXORD - an entrance for executing single and 
multi-block orders, and rewinds. 

• XORD - an entrance for executing single -block 
orders and rewinds. 

• CHKORD - an entrance for checking orders. 

• SETXORD - an entrance for establishing a new 
error exit or cancelling a previously established 
one. 

• XTAPE - an entrance for obtaining the logical 
tape unit number. 

• SPORD - an entrance for executing an MXORD 
order and establishing an error exit effective 
only for the MXORD order. 

• CLORD - an entrance for eliminating an out- 
standing order, regardless oi its status. 

For XORD, "checking an order" means "forcing the 
order to completion without errors." To achieve 
this, XORD takes corrective action when errors occur 
and/or calls for operator intervention if necessary. 
(A Rewind or a Rewind with lockout order is considered 
complete when accepted. ) 

There are three methods available to the programmer 
for checking an order. These methods are listed below 
according to their probabilities of eliminating start- 
stop tape time: 

• Issue another order to the unit. 

• Issue a CHKORD call. 



EFFICIENT USE 
OF XORD 



• Set bit 17 of the Input-Output order word. 

Whenever possible, outstanding orders should be checked 
by issuing another order to the unit, as this minimizes 
the over-all computer time used by XORD, and offers 
the greatest probability of eliminating start-stop time. 
When a single input-output area is used, it is usually 
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best to call on MXORD with bit 17 set to zero, continue 
processing which does not reference the input-output 
area and then call on CHKORD. 

Bit 17 set to one should be used only if the programmer 
would otherwise issue a CHKORD call almost immedi- 
ately after an XORD or MXORD call. - 



MXORD 



MXORD - execute Order (s) 



THE MXORD 

ENTRANCE 



To execute a read, write, space, or rewind order 
either of the following calls may be used: 



L 


Location 


Command 


Address and Kemarks 


S 


MXORD 

or 
TMA 
JMP 


ord $ 

ord $ 

SYS. 1MXORD $ 



where ord is an input-output order word with the 
following format: 



Bit Setting 



1 

1-7 

12-15 

16 



17 



18-23 
24-39 



Indication 

Indicates a read or write order. 

Indicates a space order. (If bits 
40-47 denote rewind, this bit is 
ignored. ) 

Not decoded 

The number of blocks (1-15) to be 
written, read, or spaced. 

Indicates that the order must be 
accepted before exiting. 

Indicates that the order need not be 
accepted before exiting. 

Indicates that XORD is to exit immedi- 
ately after the order is accepted. 

Indicates that XORD is to exit immedi- 
ately after the order is complete. 

PUN (Program Unit Number). 

Core Starting Address. This address 
may be indexed. 



MXORD 



Bits Setting Indication 

40-47 The Input-Output command, which 

must be one of the following: 

H/91 Read forward 

H/Dl Read backward 

H/19 Write 

H/8A Rewind 

H/8B Rewind with lockout 



STEPS TAKEN XORD attempts to issue the order specified in the A 

IN ISSUING Register. If the order is not accepted, XORD proceeds 

ORDERS according to the setting of bit 16 of the A Register. If 

the order is accepted. XORD proceeds according to the 

setting of bit 1 7. 

Rit lb If the order is not act epted, and 

• If bit 16 is one, XORD returns to the calling program 
without taking further action. (The contents of the 

A Register will have been made negative. ) 

• If bit 16 is zero, XORD will force acceptance of the 
order and then proceed according to bit 17 (see 

Bit 17 below). The A Register will be positive when 
XORD returns to the calling program. 

The following actions are taken, as required, to force 
acceptance of the order: 

• In the event of a condition which XORD cannot cor- 
rect (for example, unit in local or missing write- 
ring) operator intervention is requested by a type - 
out. 

• If a previous order to the specified unit is being 
executed, XORD waits until that order is completed 
without errors. If XORD detects an error while 
waiting, appropriate action is taken to correct the 
error. 

• If all assemblers are busy because of orders 
previously issued to other units, XORD takes the 
appropriate action to free an assembler. 
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MXORD 



mt 1 1 



If the order is accepted (see Bit 16), bit 17 is inter- 
rogated: 



• If bit 17 is zero, XORD returns to the calling 
program while the order is still being processed 
by the IOP. 

• If bit 17 is one, XORD completes the order before 
returning to the calling program. Error corrective 
action is taken if necessary. 

The following table shows the effect of various settings 
of bits 16 and 17: 



Bit 16 Bit 17 



Conditions on Return to 
Calling Prog ram 

IOP is processing order. Contents 
of A Register are positive. 

Order is complete. Contents of A 
Register are positive. 

If Contents of A Register are positive, 
Input-Output Processor is processing 
order. 

If contents of A Register are negative, 
order was not accepted. 

If contents of A Register are positive, 
order is complete. 

If contents of A Register are negative, 
order was not accepted. 



STATUS OF 
REGISTERS 
ON RETURN 



When control is returned to the main program from 
XORD, Registers A, Q, and D have been altered. No 
index registers are altered, unless a CSA is indexed 
with a counting index, in which case that index will be 
incremented once. The A Register will be positive if 
the order was accepted and negative if not (see Bit 16), 
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XORD 
XORD - Executes Order 



THE XORD To execute a rewind or a single-block read, write, or 

ENTRANCE space order either of the following calls may be used: 



L Location Command Address and Remark s 

S XORD ord $ 

or 

TMA ord $ 

JMP SYS. 1 XORD $ 



where ord is an Input-Output order word. Except for 
the contents of bits 12-15, which must be zeros, the 
format of this Input-Output order word is the same as 
that used with the MXORD call. 

See MXORD entrance for steps taken in issuing orders, 
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CHKORD 



CHKORD - Checks an Order 



THE CHKORD 
ENTRANCE 



To check an order using the CHKORD entrance either 
of the following calls may be issued; 



L 


Location 


Command 


Address and Remarks 


S 




CHKORD 
or 


unit $ 






TMA 


unit $ 






JMP 


SYS.1CHKORD $ 



where unit is a word containing the program unit 
number in bits 18-23. 

XORD returns to the calling program when the out- 
standing order to that unit is completed without errors. 
If no order is outstanding for that unit, XORD returns 

i mm ^d-i-a+^lxr 

Index registers are unaffected, the contents of Registers 
A, Q, and D are altered. 

The use of the CHKORD call does not guarantee that 
the next order for the unit will be accepted. The unit 
may be in local or the tape may be rewinding as a 
result of an outstanding Rewind or Rewind with Lockout 
order. 
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CLORD 
CLORD - Terminates an Order 



THE CLORD To force termination of an outstanding order on a unit, 

ENTRANCE regardless of its status, either of the following calls 

may be used: 



L 


Location 


Command 


Address and Remarks 


S 




CLORD 
or 


unit $ 






TMA 


unit $ 






JMP 


SYS.1CLORD $ 



where unit is a word containing the program unit 
number in bits 18-23. 

The CLORD call causes XORD to interrogate the unit 
and wait until the outstanding order is completed or 
terminated by errors (XORD does not wait for com- 
pletion of REWIND orders); a STOP order is then 
issued for the unit. 

A CLORD call should not be issued if the positioning 
of the tape or the status of the previous order to the 
unit is important. 
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▼VA-DIP 



XTAPE - Obtains Logical Tape Unit Number for PUN 



THE XTAPE 
ENTRANCE 



To obtain the logical tape unit number for the program 
unit number either of the following calls may be used: 



Location Command Address and Remarks 



XTAPE 

or 
TMA 
JMP 



unit $ 

unit $ 

SYS. 1 XTAPE $ 



where unit is a word which contains, in bits 18-23, the 
program unit number. When XORD returns control to 
the calling program, the A Register contains the cor- 
responding tape unit number in bits 18-23. The other 
bits in the A Register will be the same as the corres- 
ponding bits in unit . Registers Q, D, and JA will have 
been altered on return to the calling program; however, 
no index registers are altered. 
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ERROR EXITS AND RECOVERY PROCEDURES 



32KSYS XORD has two basically different error 
procedures: 

• A typeout/halt procedure which is used when no 
error exit has been specified (see below for 
further details). 

• An error exit procedure which requires that the 
user write an error exit subroutine and specify 
the address of the error exit subroutine by using 
SETXORD and/or SPORD calls. 



ERROR 
TYPEOUT/HALT 



If no error exit subroutine address has been specified 
and an error occurs, XORD types an error notice and 
then halts. Each error notice consists of the symbolic 
tape name, the logical unit number, and a message 
indicating the type of trouble. The following illus- 
trates the format of a full error notice: 



TSYSOUT TAPE 5 SI ERROR 

The following table lists the possible messages and 
their meanings. 



ERROR 
MESSAGES 



Message 



Meaning 



IN LOCAL Unit is mechani- 
cally unavailable, 

WRT NABL Unit should be 
write enabled. 



Suggested Oper- 
ation Action 

Place tape in remote 
and press advance. 

Write enable the 
tape and press ad- 
vanc e . 



ROCKED 



XORD has made 
repeated unsuc- 
cessful attempts 
to fix parity and/ 
or sprocket er- 
rors, (five erase 
resume actions 
for a write order; 
ten retries for a 



Dump job or press 
advance to retry. 
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ERROR 

MESSAGES 
(Continued) 



Message Meaning 

read order, five 
in each direction). 

ILL.WRT XORD has been 
told to write on 
a tape that is 
not write -enabled 
and should not be 
used as an output 
tape , 

PROG The calling pro- 

ERR gram has erred 

(possibly an im- 
proper XORD 
parameter) - 

SYS ERR The hardware is 

malfunctioning 
(possibly XORD 
program has 
been partially 
clobbered) , 

DISABLED Unit became 

mechanically dis- 
abled while exe- 
cuting an order, 

BEG TAPE XORD has been 
told to process 
a block prior to 
first block on 
tape. 



END TAPE 



SI 
ERROR 



XORD has been 
told to process 
a block after 
last block on 
tape. 

A begin block 
mark has been 
missed. 



Suggested Oper- 
ation Action 



Dump job. 



Dump job. 



Dump job. 



Dump job. 



Dump job. 



Dump job. 



Dump job. 
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ERROR 

MESSAGES 

(Continued) 



Message 

S2 
ERROR 



Meaning 

An end blockmark 
has been missed. 



Suggested Oper- 
ation Action 

Dump job. 



BAD FIX A serious error Dump job. 

has occurred while 
XORD was trying 
to fix parity and/ 
or sprocket errors. 

FAULTY Some combination Dump job. 

of faults has ot - 
curred or the hard- 
ware is malfunc- 
tioning. 
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SETXORD 



SETXORD - Establishes Error Exit 



THE SETXORD 
ENTRANCE 



An error exit may be established by either of the 
following two calls: 



L Location Command Address and Remarki 



SETXORD 

or 
TMA 
J MP 



param $ 



•tram $ 



lYS. 1SETXRD $ 



where param is a word which has the following form: 

P/ERRORX, F40$ 

ERRORX is the address of an error exit subroutine and 
must not be an indexed address. The error exit sub- 
routine thus specified will be used for all orders not 
issued with SPORD calls until another SETXORD call 
is given to XORD. A aero error exit address indicates 
that no error exit subroutine is available (except for 
orders issued with SPORD calls). At the beginning of 
each job the operating system issues a SETXORD call 
specifying a aero error exit address. 
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SPORD 



SPORD - Establishes Error Exit for a Particular Order 



THE SPORD 
ENTRANCE 



A special error exit address may be established {to be 
used for a particular order) by either of the following 
two calls: 



L Location Command Address and Remarks 



SPORD 
or 

TMA 

JMP 



param $ 

param $ 

SYS. 1SPORD $ 



where param is a word which has the following form: 

C/HLTL, CALLWORD.P/SPECIAL.ERRORX, F40 $ 

CALLWORD is the address of a parameter suitable for 
an MXORD call. SPECIAL- ERRORX is the address of a 
special error exit subroutine which XORD will use if and 
only if trouble occurs due to the order in location CALL- 
WORD. The special error exit subroutine will not be 
used for troubles on other units or for errors attributable 
to the previous/next order to the unit specified in loca- 
tion CALLWORD (the typeout/halt procedure or the error 
exit subroutine specified by a SETXORD call will be used 
for these conditions). SPECIAL. ERRORX must not be an 
indexed address. 
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ERROR EXIT 



INTRODUCTION 



This discussion is applicable to error conditions other 
than unit mechanically unavailable and tape not write 
enauied, which always result in the typeout/halt action 
(see above). If trouble occurs and an error exit sub- 
routine has been specified (see SETXORD and SPORD 
calls) XORD saves information required for restarting, 
which could be clobbered by calls on XORD, and sets a 
switch to prevent the clobbering of this data in the event 
of a subsequent error exit. In the following description 
this switch is referred to as XSWITCH. It is assumed 
that the error exit subroutine is entered via the following 
coding 



L Location Command Address and Remarks 



RETURNA JMP 
RETURNB JMP 
ERRORX TJM 

TJM 
INCA 



(P) $ 

(P) $ 

RETURNA$ 

RETURNB$ 

RETURNB$ 



CONDITIONS 
ON EXIT 

O Register 



The following information is available to the error exit 
subroutine when it is called by XORD. 

The last order (in MXORD format) issued by XORD to 
the unit in trouble. Bits 1-6 contain the program unit 
number and bits 20-23 contain the logical unit number. 
The core starting address, if applicable, reflects index 
mg, if any This order is not involved in the trouble 
which resulted in XORD calling on the error exit sub- 
routine if the status word indicates no Input- Output 
Processor faults. 



A Register 



An XORD status word for the unit in trouble. Bits are 
set as described below: 



Bits 


1 



Meaning 



Undefined. 



Bad fix (serious trouble while fix parity/ 
sprocket error) 



2-3 



Undefined 
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ERROR EXIT 

Bits Meaning 

4 Rocked (too many parity/ sprocket fix attempts). 

5 . Program error (possibly an improper XORD 

parameter). 

6 Disabled transport. 

7 SI error. 

8 S2 error. 

9 Sprocket error, 

10 Illegal write order li bit 5 is set otherwise IOP 

malfunction. 

1 1 Parity error 

12 IOP malfunction. 

13 Begin tape 

14 End tape 

1 5 Space fault 

16-19 Undefined 

20-23 Number of blocks remaining to be processed 

as indicated by assembler counters. 

24-45 Undefined. 

46 Same as bit I . 

47 Same as bit 4 

Indexed Table A table of connectors and error recovery data used by 

XORD and available to the error exit subroutine subject 
to the constraints listed under Error Recovery Rules 

Location Contents 

00, IX C/JMP, XORD. FINIS; C/JMP, XORD. EXIT$ 

where XORD. FINIS is the address of coding 
which restores main -program (program which 
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ERROR EXIT 



Location Contents 



imi 



called XORDj index registers IX and IS. 
then returns control to the main program 
XORD. EXIT is tne address ot the JlViP com- 
mand which returns control to the main pro- 
gram, (Neither of these JMP commands is 
to be used without first executing JMP 9, 1$ 1 
The contents of Registers A and Q are no' 
altered by use cf these JUMP comn < r,H -- 
indicators can be given to the main pr*,^; - 
via A and O 

01- IX Current callword in MXORD format The core 

starting address, if applicable reflects index 
ing if any The program unit number appear- 
in bits 1-6 as well as m bits 18 23 

02 IX Main program index registers IX and 2X The 

contents of IX are m the left address with the 
C Bit scaled at Tib; the contents of 2X are in 
the right address, with the C Bit scaled at T40 

03, IX Undefined 

04, IX Input Output Processor order in machine lan- 

guage format which XORD is currently trying 
to issue, This word is D/0$ if XORD is cur- 
rently checking an order CHKORD call or final 
phase ot XORD / MXORD/SPORD call with hi! 
17 set to zero) rather than trying to issue <m 
order, 

05, fX Undefined. 

07. IX Undefined 

08, IX Entrance to XORD typeout subroutine, JMPL 

08 1X$ will result in XORD typeout of an error 
notice followed by return of control to the com 
mand following the JMPL 08. 1 X$ instruction 
The contents of IX will not be altered. See 
TYPEOUT/HALT for the possible error notices 
which may occur If for example the error 
exit was due to an end of tape error for symbolic 
tape PILE 04, logical unit number 12, the JMPL 
08, 1X$ the instruction would i.ust the follow 
ing typeout; 

FTT.F: Tj4 TAPF i> nur: r a Dt 
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ERROR EXIT 



Location 



Contents 



09, IX Entrance to an XORD subroutine which resets 

XSWITCH (see above). If XORD is not re- 
started via RETURNA or RETURNB, a JMPL 
09, IX must be executed. Control will be ret ■ 
urned to the command following the JMPL 
09, 1X$ instruction with the contents of A,P, 
and all index registers unaltered, 

ERROR RECOVERY The data described above may be used by the error exit 
RULES subroutine subject to the following rules; 

1. No part of the table indicated by the contents of IX 
may be altered. 

2. A JMPL 9, IX must be executed if XORD is not re 
started via RETURNA or RETURNB, 

3. If corrective action involving calls or. XORD itself 
is taken, a JMPL 09, 1X$ instruction must not be 
executed prior to any of these calls, 

4. If XORD or MXORD calls are issued, another error 
exit may result. Therefore, it is advisable to use 
SPORD calls in the error exit subroutine, specifying 
special error exit addresses within the error exit 
subroutine itself. 



ADDITIONAL 
ERROR 
RECOVERY 
INFORMATION 



The following information will probably be of use in 
writing an error exit subroutine. 

1. When XORD calls on an error exit subroutine, the 
unit in trouble is available if bit 6 is zero and the 
transport is not disabled. XORD has waited for the 
tape to stop and has issued a STOP order. 



When XORD calls on an error exit subroutine, at 
least one assembler is available. 

Unlike previous versions of XORD, an error exit 
subroutine is not called unless the trouble involves 
the unit specified by the current call on XORD. 

JMP RETURNA will result in the normal XORD 
TYPEOUT/HALT action. XORD will pretend that 
it never called the error exit subroutine. 
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5. JMP RETTJRNB$ will result in restarting XORD 
as though the trouble and subsequent call on the 
error exit subroutine had not occurred. 

II the contents of the A Rigisti r are not zero when 
JMP RETURNB$ is executed, XORD will assume 
that the A Register contains an order which is to 
replace the order outstanding for the unit in trouble, 
This order must be in the same format as the con- 
tents of the O Register on entry to the error exit 
subroutine. XORD assumes that this order has 
been issued by the error exit subroutine and it is 
used by XORD tc update its list of outstanding orders, 
Use of this feature is not required if the error exit 
subroutine uses XORD to issue orders. 

6. If an error exit occurred because a tape was 
ROCKED (bit 4 or bit 47 of status word is set to 
one), the following is applicable: 

a. For a writp nrrie-r an o-ac«a ^tA*>-~ u-,- -,i___j__ 

—_., „.. w*«.^j^ uiuti nao an CdUV 

b. For a read order, XORD has issued and com- 
pleted a reverse read order. The block in- 
volved in the parity/sprocket trouble will be 
the next block processed or spaced over, if an 
order (specifying the original direction) is 
issued to the unit. 

'. When an error exit occurs, the address of the unit 
in trouble is not necessarily contained in the unit 
address register oi an assembler, This means 
that while Class A orders and rewind orders will 
be accepted because an assembler is free and a 
stop has been issued to the unit in trouble. Class 
B and C orders may not be accepted. 
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SECTION V 



CONTROL LINE FUNCTIONS 



The fundamental operations of 32KSYS, such as loading 
programs into memory, reading and writing on tape, 
and starting and stopping runs, are called into action 
by 3ZKSYS Control Lines - each consisting of a control 
instruction and its parameters, 



SOURCES OF 

CONTROL 

LINES 



A Control Line must be written in a format similar to 
that for TAC instructions and may be entered into the 
computer from either of the following sources: 



Cards via the 32KSYS input tape 
Console Typewriter (manually). 



CONTROL 

LINE 

FORMAT 



The format for 32KSYS Control Lines is illustrated 
below, indicating the location of columns, fields, and 
Console Typewriter tab settings, including the left 
margin for the typewriter. 



FIELDS 



COLUMNS 




CONSOLE TYPEWRITER TAt SETTINGS 






RHILCO 

' ( OMMIInTcaTiONS AND ' 
t ifCIRONlCS DIVISION 



PHILCO CODING FORM 



Page of 



Program: 



IDENTITY AND 
SEQUENCE 

7 * « 4 4 7 • 



LOCATION 



Oil 17 II 14 It l* 



COMMAND 



7 1* I* TO 71 22 71 2' 



Programmer: 



Date 



ADDRESS AND REMARKS 



2*> 7* 77 2* 7* 10 II I? '1J 14 IS 14 1/ It ]• 40 • 1 1 4? 4) ■« «•, 44 «' 44 U* SO V- ■>,' 



S4 *4 4» 41 hi 41 44 < fct 44 47 4* 44 '0 71 >?['! 74 7* 7* 7? ■ 7» 



I ; J « •> 4 7 4 4 10 : I i ? 
CC Hlf 



70 J! /? 71 J4 7* 74 77 71 7* *C n f( it 14 ts 14 I ' t« r* 



44 4 ■ 44 «• S,.j ■* 



i • \m 14 



41 44 44 4* 4 7 4* ** 'O 7! 7J 'I 74 f* 7(, M r« ?* 80 



Information should be written within each field as follows: 

• Label Field (Column 9). An L or an R normally 
placed in this field indicates whether the left or 
right half of an instruction or an address is to be 
acted upon by a control instruction. 

For the Console Typewriter, the single character is 
entered before the first tab setting following a 
carriage return. 

• Location Field (Columns 10-16). Normally the octal 
address of an instruction or data to be acted upon by 
a control instruction is placed in this field. 

For the Console Typewriter, information for this 
field is to be entered between the first and second 
tabs following a carriage return. 

• Command Field (Columns 17-24). The control line 
command is to be placed in this field. 

For the Console Typewriter, the field is between 
the second and third tabs following the carriage 
return. 

• Address and Remarks Field (Columns 25-80). The 
parameters are to be written in this field in the 
following manner: 

1. Parameters must be separated by break charac- 
ters, i.e., acomma(,), semicolon ( ;), period 
(.), or slash (/). No distinction is made between 
these characters, except where otherwise noted. 

2. The last parameter must be followed by a dollar 
sign if remarks are to follow. 

For the Console Typewriter, information for the 
Address and Remarks field is to be entered following 
the third tab. 

REMARKS 1. If any control line command Is illegal or, in general, 

if any of its parameters are illegal, an error type- 
out will be typed on the Console Typewriter, unless 
otherwise noted, and control is transferred to 
1XCONER. 
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2. If a control line error has occurred while entering 
control lines from the Console Typewriter, a JOB 
control instruction must be entered to clear 32KSYS 
of the error condition. 

3. Upon completion of successful action of control in- 
structions, control is generally transferred to the 
32KSYS entry 1NXTCON, which requests and 
attempts to execute the next control instruction. 



WRITING 
CONTROL 

LINES 



4. The Philco Coding Form is provided for the user's 
convenience in writing his programs. Philco 2000 
TAC cards are available for punching the information 
from the Coding Form. 

As indicated, the command word of 32KSYS control line 
is to appear in the Command field of a card, and the 
parameters are to appear in the Address and Remarks 
field. To simplify explanation of these lines, all capi- 
talized words which appear within the illustration of the 
instruction format below are to appear on the card 
exactly as shown. All underlined words in lower case 
are to be replaced - generally by an L or R in the Label 
column, an address in the Location field, and parameters 
selected by the programmer in the Address and Remarks 
Field. 



For example, the instruction LOCTACL is described as: 



L Location Command Address and Remarks 



LOCTACL t, id, sent 



CONTROL 

LINE 

FUNCTIONS 



Although commas are used in format examples throughout 

the manual, any of the acceptable break characters 

(, ; . /) are permissible except where otherwise noted. 

32KSYS control lines are grouped according to function 
into nine classifications. These functions, their meaning, 
and an example of a particular control instruction within 
each function are listed as follows: 



CONTROL 
LINE 

FUNCTIONS 
(Continued) 



Function 



Initialization 



Compilation 



Meaning 

Instructions used to pre- 
pare the System for 
compilations or runs. 

Instructions used to call 
in the compilers and 
initiate source program 
conversion from mne- 
monic coding into machine 
language. 

Instructions used to load 
an object program into 
memory and initiate the 
running of the program. 

Instructions used to divide 
a program into smaller 
segments to permit load- 
ing and running of only 
parts of the program in 
memory at a given time. 



Tape Handling Instructions used to read 
from, write onto, or re- 
wind magnetic tapes. 



Loading 



Segmentation 



Debugging 



Special 



Instructions used to aid 
the programmer in diag- 
nosifig and patching pro- 
grams which may be 
faulty. 

Instructions used to per- 
form miscellaneous func- 
tions on the computer, 
such as setting a pseudo 
toggle register, clearing 
memory locations, halting 
an operation, or trans- 
ferring control to a mem- 
ory location. 



Example 



JOB 



TAC 



REL 



SEGMENT 



READF 



DUMP 



SYS OPS 



*-*, 



CONTROL 

LINE 

FUNCTIONS 

(Continued) 



Function 

Service 
Routine 



Application 



Meaning 

Instructions used to call 
in routines whose func- 
tions are tape mainte- 
nance, debugging, and 
program monitoring. 

Instructions used to call 
in application systems 
which run under control 
of the 32KSYS monitor. 



Example 



RPLC 



PERT 
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SECTION VI 
INITIALIZATION FUNCTIONS 



The JOB control instruction prepares 
the System for a new program, and 
the CONIN instruction specifies the 
source of control instructions. 



JOB 



JOB 



FUNCTION 



FORMAT 



Prepares the System for a new job or series of oper- 
ations and identifies the job. JOB is the highest level 
instruction in the 32KSYS hierarchy; therefore each job 
must begin with a JOB control instruction. 



L 


Location 


Command 


Address and Remarks 






JOB 


ident 



PARAMETER 



ACTION 



ident - 16 or fewer alphanumeric characters * which 
identify the job to be processed. 

Execution of the JOB control instruction initiates the 
following action: 

TSYSDMP is rewound. 



All tapes except those assigned to System names or 
those assigned to names held for the next job (refer 
to TAPES Instruction) are rewound with lockout. 

All symbolic tape names except System names and 
those held for the next job are released. 

An end-of-job message is written on TSYSOUT. 

The RPL, REL, and ABS loaders are reset, i.e., 
common origin is reset to 10000 g, common storage 
area reset to 0, etc. . 

The DUMP control instruction table and the CONBIT 
word are cleared. 

The indicator words 1IBIT and 1SYSOPS are cleared. 

Memory is cleared from location 10000g to the end 
of memory. 



The effective end of memory is reset to 77777 
All index registers except 1 and 2 are cleared. 
The System jump vectors are reset. 



8 



o-c 



JOB 



• The JOB card is typed on the Console Typewriter. 

• The date and time from the Accounting Clock are 
typed on the Console Typewriter. 

j» The edited coding for the JOB page is written on 
TSYSOUT for printing. 



* Only those characters which are upper case characters of the Console 
Typewriter should be used. 
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3NIN 



CONIN 



UNCTION 



Specifies a new mode of input. 



ORMAT 



L 


Location 


Command 


Address and Remarks 






CONIN 


mode 



ARAMETER 



mode - One of the following must be selected: 



CODE; - Indicates that the next 32KSYS control instruc- 
tion is in Code Mode. 

IMAGE - Indicates th.it the next 1-iKSYS control instruc- 
tion is in Image Mode. 



ACTION 



Whenever CONIN is executed, 1ZKSYS expects to receive 
its next control instruction in the mode specified by 
mode . 



£ = -* 



SECTION VII 
COMPILATION FUNCTIONS 



This group of control instructions 
specifies the type of compilation to be 
made using 32KSYS as an executive 

routine. 
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TAC 



TAC - Translator-Assembler-Compiler 



FUNCTION 



FORMAT 



Initiates a TAC compilation 



PARAMETERS 



Location 



format 



Command 



TAC 



Address and Remarks 



source , lib , subs , 
NOCARDS, NOPROG 



format - The format in which the program is to be com- 
piled. If omitted, REL is assumed. 

REL - Indicates relocatable binary card format. 

ABS - Indicates absolute binary card format. 

RPL - Indicates tape (running program language) 
format. 

source - The source of the TAC language program. If 
omitted, TSYSIN is assumed. 

MAGTAPE - Indicates that the source is the system 
input tape, TSYSIN. 

MAGTAPE, _t_ - Indicates that the source is the 
symbolic tape, t_. 

HbJOPTIONAL) - Indicates that subroutines are to be 
included in the object program. 



LIB, tj 



.. t - Indicates 1-7 symbolic tapes to 
_n be used as sources for the sub- 
routines to be copied. If only 
LIB is specified, the system 
library tape, TSYSLIB, is as- 
sumed. 



subs (OPTIONAL) - Indicates whether subroutines from 
"""""the TAC library are to be compiled with the program. 

SUBS - Indicates that subroutines are to be compiled. 
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TAC 



NOSUBS - Indicates that no subroutines are to be 
compiled. 



ACTION 



REMARKS 



Note: If omitted, RPL and ABS compilations assume 
SUBS: REL compilations assume NOSUBS. 

NOCARDS - Indicates that no cards will be produced on 
TSYSOUT for REL and ABS programs. 

NOPROG - Indicates that the machine language program 
will not be produced on the System's or User's Pro- 
gram Tape. 

• The TAC language program is compiled and machine 
language output, a Code -Edit, and edited cards for 
punching (if format were ABS or REL) are created. 

• The machine language output is produced on the 
System's or the User's Program Tape unless the 
NOPROG parameter was specified or compilation 
errors were detected in the source program. If 
there were compilation errors, the compiler re- 
stores the Program Tape to its position at the start 
of the compilation. A block of Z's is written on the 
Program Tape and the tape is positioned immediately 
prior to that block of Z's. The Code-Edit is pre- 
pared and written on TSYSOUT for off-line printing 
on the High-Speed Printer in Data Select 0. 

• The edited cards are produced on TSYSOUT for off- . 
line punching in Data Select 1, unless the NOCARDS 
parameter was specified. 

1. If a TAC compilation is successfully completed, the 
compiler returns to the system via SYS. 1NXTCON, 
where the next control instruction is executed; 
otherwise it returns via SYS. 1COMPER where the 
remaining control instructions in the JOB are 
investigated. If the control instruction is one of 
the following, it is executed; otherwise a search 
for the next JOB is initiated. This process continues 
until a JOB instruction is encountered. 
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TAC 



ALTAC 

ALTAC3X 

CLOCK 

COBOL 

FORTRAN 



HLT 

IB IT 
JOB 

LOCTACL 
NOPRINT 



OPAL 

PRINT 

RELEASE 

REM 

REPORT 



REWIND 

REWINDLO 

SYSOPS 

TAC 
TAPES 



If a serious tape error is detected during a compila- 
tion and the operator returns control to the system 
via memory location 1, the Program Tape is re- 
stored to its position at the start of the compilation. 

The 32KSYS control instruction, SYSOPS, offers 
the programmer a means of supplying the TAC com- 
piler with optional modes of operation. 

Edited cards for punching are produced on TSYSOUT 
even if compilation errors were detected, unless 
NOCARDS was specified as a parameter. 

An asterisk in the Address and Remarks field of the 
TAC control instruction indicates that the TAC 
language input is on TSYSIN and the library to be 
used is TSYSLIB. An asterisk is equivalent to 
MAGTAPE, TSYSIN, LIB, TSYSLIB. 

A blank Address and Remarks field in the TAC 
control instruction indicates that the TAC language 
input is on TSYSIN and there is no library tape. 
This is equivalent to MAGTAPE, TSYSIN. 



CONSOLE 
TYPEWRITER 
NORMAL 
TYPE-OUTS 



Message Explanation 

ID IS id Start of compilation, where id is the 

program identity. 

nnnnCRDS End of ABS or REL compilation, nnnn 

is the number of cards produced on 
TSYSOUT. 



nnnnB LKS End of successful RPL compilation. 

nnnn is the number of blocks on the 
Program Tape. 
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TAC 



CONSOLE 

TYPEWRITER 

NORMAL 

TYPE-OUTS 

(Continued) 



Message Explanation 

ENOCMP End of successful compilation and the 

programmer specified NOPROG (in case 
of RPL) or NOCARDS (in case of ABS 
or REL). Control is returned to the 
operating system via SYS. 1NXTCON. 



CONSOLE 
TYPEWRITER 
ERROR 
TYPE-OUTS 



Message Explanation 

TAPE t Table of contents of library tape is not 

BAD LIB acceptable. Compiler exits to 

SYS. 1COMPER. 



TAPE t^ Tape t_is not a library tape. Computer 

NO LIB halts. 

GENERR Either library or generator error or 

insufficient parameters in generator 
call. Generation is terminated and 
compilation continues. 

nDMPTAC Machine or compiler error. Computer 
Halts, n indicates the compiler pass 
where error was detected, 

CMPERRS Source program error detected. The 
compiler restores the Program Tape 
to its position at the start of the com- 
pilation (before a block of Z's). 
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ALTAC 



ALT AC - Algebraic Translator into TAG 



FUNCTION 



FORMAT 



Initiates an ALTAC III compilation. 



L 


Location 


Command 


Addren and Remark* 




format 


ALTAC 


source, lib, subs, 
NOCARDS, NOPROG, 
NOTAC 



PARAMETERS 



The parameters for ALTAC are the same as for TAC 
except for the additional NOTAC parameter. 



REMARKS 



NOTAC (OPTIONAL) - Indicates the TAC assembly 
phase of the compilation is to be bypassed. The 
generated TAC program is on TSYSCR6. 

For a complete description of the parameters, action, 
and typeouts that can occur during an ALTAC compilation 
refer to the TAC description. 



The following error typeouts can occur during an ALTAC 
compilation in addition to those described under TAC: 



CONSOLE 
TYPEWRITER 
ERROR 
TYPE-OUTS 



Message Explanation 

EALTAC A source language error has been 

detected that would cause generation 
of an incorrect object program. The 
TAC assembly is bypassed and control 
is returned to SYS via SYS. 1COMPER. 
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ALTAC3X 



ALTAC3X - A Fast Compile -and-Go Version of ALTACIII 



FUNCTION 



FORMAT 



Initiates an ALTAC3X compilation. 



Location 



ABS 



Command 



ALIAC3X 



Address and Remarks 



source, lib 



PARAMETERS 



ACTION 



ABS is the only format in which the object program of 
an ALTAC3X compilation is produced. 

For a complete description ot the parameters refer to 
the TAC description. 

Execution of the ALTAC3X control mstruction initiates 
compilation of the source program, creation of cards, 
and the following printer output on TSYSOUI : 

• The listing of the source program 

• The identities of the LIBRARIES USED 

• The ASTORS resulting from DIMENSiON state- 
ments and ASTORS m a TAC insert. 

• Thf PROGRAM MAX indicating the next available 
memory location following the program 

• The address where POOL CONSTANTS begin 

• The END CARD JUMP ADDRESS 

e A soited SYMBOL TABLE containing statement 

numbers, names of variables, and symbols. Except 
for symbols of the form nnnnnS N (where nnnnn 
represents a statement number), symbols beginning 
with a numeric character are not printed. 

• The number of ABS cards produced including the 
dummy PMAX card. 



ALTAC3X 



The machine language output is produced on the 
System's or the user's Program Tape unless 
compilation errors were detected in the source 
program. If there were compilation errors, the 
compiler restores the Program Tape to its position 
at the start of the compilation. 



REMARKS 



1. ALTAC3X differs from ALTAC III as follows: 



a) ALTAC3X does not produce an edited listing 
of the object program. 

b) ALTAC 3X produces ABS output only, and 

c) ALTAC3X source programs may not include 
relocatable binary decks. 

2. ALTAC3X comprises the three RPL programs: 

PHASE 1: A modified version of the ALTAC III 
translator, 

PHASE 1: A modified version of the first pass 
of TAC, 



PHASE 3: 



A modified version of the second pass 

of TAC 



3. Remarks i and 1 in the TAC description also apply 
to ALTAC3X. 



CONSOLE 
TYPEWRITER 
NORMAL 
TYPE-OUTS 



Refer to typeouts and explanations in the TAC description. 



CONSOLE 
TYPEWRITER 
ERROR 
TYPE-OUTS 



Message Explanation 

CMPERRS Source program error detected. 

Compilation ends, no object program 
is produced, and control is returned 
to the operating system via SYS. 
1COMPER. 



i -o 



GENERR Either library generator error or in- 

sufficient parameters in generator call. 

Generator is terminated and compilation 
continued. 



ALTAC3X 



CONSOLE 

TYPEWRITER 

ERROR 

TYPE-OUTS 

(Continued) 



Message Explanation 

MCHERRn Machine or compiler error. Computer 
halts with the address field of the HLT 

instruction representing the location 
where phase n detected the error. 

TAPE n Tape n is not a library tape. Computer 

NO LIB halts. 



TABOVER TAC symbol table over-flow. Compila- 
tion ends, no object program produced, 
and control is returned to the operating 
system via SYS. 1COMPER. 

TAPEn Table of contents of library tape n is 

BAD LIB not acceptable. Control is returned to 

the operating system via SYS. 1 COMPER , 



PRINTER 
ERROR 

INDICATIONS 



Errors on the Printer output are indicated as follows, 
depending upon the compiler phase in which the error 
was detected. 



• Source program errors detected during the first 
phase of the compilation are indicated in the source 
program listing, and compilation ends after the 
first phase. 

• Errors detected in later phases are indicated in 
octal in the word ERRINDS. The bits of this word 
are interpreted as follows: 

Bit Significance 

LABEL FIELD ERROR 

1 COMMAND FIELD ERROR 

3 AMBIGUOUS OR CONFLICTING F-BITS 

4 LOCATION FIELD ERROR 

5 DOUBLE ASSIGNMENT 

8 ADDRESS OF NEXT INSTRUCTION CYCLES 
MEMORY 

9 ILLEGAL CONSTANT PREVIOUS CARD 

10 ADDRESS FIELD ERROR 

11 TOO MANY NAMES, NONAME USED 

12 NAME FIELD ERROR, NONAME USED 

14 CONTROL CARD ADDRESS FIELD ERROR 

18 END CARD ADDRESS ERROR 
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.TAC3X 



Bit Significance 

22 ILLEGAL CONTINUATION CARD 

23 CSA OF BINARY CARD IMPROPER, USED ZERO 

24 BINARY CARD xxxx BAD ( xxxx is an identity 
and sequence number) 

25 DOUBLE ASSIGNMENT WOULD OCCUR IF 
SYMBOL WERE COMMON 

26 SET PARAMETER NOT PREVIOUSLY DEFINED 
37 gass NOT DEFINED ( asss represents a symbol) 
40 IMPROPER REFERENCE TO INDEX REGISTER 
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COBOL 



COBOL 



FUNCTION 



FORMAT 



PARAMETERS 



REMARKS 



Initiates a COBOL compilation. 



Location 



format 



Command 



COBOL 



Address and Remarks 



source , lib , sub , 
NOCARDS, NOPROG, 
NOTAC 



The parameters are the same as those for the ALTAC 
control instruction. For a complete description, refer 
to the parameter explanations of TAC and ALTAC. 

The COBOL library may be mounted on a tape with the 
symbolic name COBOLIB instead of being combined 
with the regular TAC library (TSYSLIB). If COBOLIB 
is used for the COBOL library, bit 19 of the CONBIT 
WORD, 1CONBIT, must be set to 1. The setting of 
this bit is an installation option. 



CONSOLE 
TYPEWRITER 
ERROR 
TYPE-OUTS 



Message 

NO LIB 

ECOBOL 



Explanation 

A COBOL library required by the 
source program is not mounted on the 
correct tape . 

A source language error has been 
detected that would cause generation 
of an incorrect object program. The 
TAC assembly is bypassed and control 
is returned to the operating system 
via SYS. 1COMPER. 



MACHERR 



A machine or compiler error has 
occurred. 
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OPAL 



OPAL - The Assembly Language for Philco 1000 



FUNCTION 



Initiates an OPAL assembly. 



FORMAT 



L 


Location 


Command 


Address and Remarks 






OPAL 





ACTION 



Execution of the OPAL control instruction initiates the 
following action: 

• The OPAL language program is assembled and an 
object program and a code edit are created. 

• The format of the object program produced is 
dependent upon the OPAL "OPTIONS" control card 
which should immediately follow the I card. ABS 
(absolute binary) card format is the standard 
object program format produced by the assembler. 
The cards are edited for punching with data select 

1 and written on TSYSOUT. If the MAGTAPE para- 
meter is specified in the "OPTIONS" control card, 
the object program is produced in magnetic tape 
format (1024 characters per block). 

In this case the object program is written on 
TSYSCRO rather than on TSYSOUT. If the n para- 
meter is used, the program is written on tape n 
instead of on TSYSCRO. (A TAPES control card 
may be required.) The loader program produced 
by the assembler, when the MAGTAPE parameter 
is specified, occupies the first 168 characters of 
the first block. 

• The Code-Edit listing produced by the OPAL as- 
sembly is written on TSYSOUT, edited for printing 
with data select 0. 



CONSOLE 
TYPEWRITER 
NORMAL 
TYPE-OUTS 



Message Explanation 

ID IS id Program identity, represented by id, 

is typed out after the first source card 
is read. 



CONSOLE 
TYPEWRITER 
NORMAL 
TYPE -OUTS 
(Continued) 



Message 

PROGRAM 
TAPE IS n 



OPAL 



Explanation 

The Object Program Tape is n. This 
type -out doe 8 not occur unless the 
program changes normal assignments. 



nnnC RDS This type -out occurs at the end of the 

assembly for card output; nnn is the 
number of cards written on the Object 
Program Tape and/or TSYSOUT. 



CONSOLE 
TYPEWRITER 
ERROR 
TYPE-OUTS 



Message 

INSUFFI- 
CIENT 
MEMORY 



Explanation 

OPAL requires a minimum memory 
of octal 27000 to run. 



OPAL Assembler error or machine mal- 

ERROR function. 



REPORT GENERATOR 



REPORT GENERATOR 



FUNCTION 



FORMAT 



REMARKS 



Initiates a REPORT GENERATOR compilation. 



L 


.Location 


Command 


Address and Remarks 




format 


REPORT 


source, lib, subs, 
NOCARDS, NOPROG, 

NOTAC 



For a complete description of the parameters, action, 
and typeouts that can occur during a REPORT GENER- 
ATOR compilation, refer to the TAC and ALTAC de- 
scriptions. 



The following error typeouts can occur during REPORT 
GENERATOR compilation in addition to those described 
under TAC: 



:onsole 



Message 






ERROR 
TYPE-OUTS 



EREPORT An excessive number (more than 255) 
of errors were detected in source pro- 
gram. 



The TAC assembly is bypassed and 
control is returned to 32KSYS via 
SYS. 1COMPER. 

MACHERR Computer halts. Generator program 
flow is in error because of machine 
failure. 
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FORTRAN 



FORTRAN 



FUNCTION 



Initiate* a FORTRAN IV compilation. 



FORMAT 



L 


Location 


Command 


Address and Remarks 






FORTRAN 


source, lib, NOCARDS, 
NOPROG, MAP, EDIT, 
NODEBUG, BATCH 



PARAMETERS 



The machine language program output of a FORTRAN 
IV compilation is in relocatable binary card format 
written on the system output tape, TSYSOUT, edited 
for punching, and/or on TSYSCR4 or the User's Pro- 
gram Tape, for subsequent loading and execution. 

source - the source of the FORTRAN IV language pro- 
gram. If omitted, TSYSIN is assumed. 



MAGTAPE - Indicates the source is the system 
input tape, TSYSIN. 

MAGTAPE, t - Indicates the source is symbolic 
tape £in CODE mode (SYSOPS 3 
and 4 are not permissible). 

lib - Indicates that all called subroutines are to be in- 
cluded in the object program deck. 



LIB, t 2 , . . 



In 



Indicates 1-7 symbolic tapes 
to be used as sources for the 
binary relocatable subroutines 
to be copied. 



NOCARDS - Indicates that the object program is not to 
be written on TSYSOUT edited for punching. 

NOPROG - Indicates that the object program is not to 

be written on TSYSCR4 or the User's Program Tape, 

MAP - Indicates that a storage map of the object pro- 
gram is to be written on TSYSOUT, edited for print- 
ing. 



FORTRAN 



EDIT - Indicates that a listing of the object program is 
to be written on TSYSOUT, edited for printing. 
Selection of the EDIT option implies the selection of 
the MAP option, also. 

NODEBUG - Indicates that generation of information for 
the traceback routine is to be inhibited. 

BATCH - Indicates that multiple compilations are to be 
performed, the end of which is signaled by the oc- 
currence of a COMPLETE card immediately following 
the END statement of the last program in the batch. 
Each compilation in the batch is controlled by the para- 
meters in the FORTRAN call and behaves as any non- 
batch compilation except that library routines are 
copied, if the lib parameter was specified, at the com- 
pletion of the batch rather than at completion of each 
compilation. Only one copy of each called subroutine 
is included regardless of the number of compilations 
calling the subroutine. 



ACTION 



Execution of the FORTRAN control instruction causes 
the following action: 



The FORTRAN IV language program is compiled 
and machine language output, a source program 
listing, an object program edit and storage map, 
and cards edited for punching are produced, ac- 
cording to the options selected. 

The machine language output is produced on the 
System's or User's Program Tape and the tape is 
left positioned immediately following the program 
produced, unless the NOPROG option was selected 
or compilation errors detected. If compilation 
errors were detected, the compiler restores the 
tape to its position at the start of the compilation. 

The source listing, error comments, object pro- 
gram edit, and storage map are produced on the 
system output tape, TSYSOUT, edited for off-line 
printing in Data Select 0. 

The object program cards are produced on the sys- 
tem output tape , TSYSOUT, edited for off-line 
punching in Data Select 1, unless the NOCARDS 
option was selected or compilation errors detected. 
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FORTRAN 



Because some errors are not detected until the 
last phase of the compilation, the edited cards may 
be produced even though compilation errors exist. 
In no case will library routines be included (copied) 
if errors were detected in the source program. 

If a FORTRAN IV compilation is successfully com- 
pleted, the compiler returns control to the system 
via SYS.1NXTCON, where the next control instruc- 
tion is executed; otherwise it returns via SYS. 1 
COMPER where the remaining control instructions 
in the JOB are investigated. If the control instruc- 
tion is one of the following, it is executed; otherwise 
a search for the next JOB is initiated. This process 
continues until a JOB instruction is encountered. 



ALTAC 
ALTAC 3X 

IE IT 
LOCWCL 

NOPRIKT 
OPAL 



COBOL 

CLOCK 

FORTRAN 
HLT 
JOB 



RELEASE 

REM 

REPORT 

REWIND 

PhlMT 



REWINDLO 
SYSOPS 
TAC 
TAPES 



REMARKS 



1. A serious source program error detected in a 
batch compilation affects only the output of the 
compilation of that program containing the error 
except that the lib option, if selected, is ignored 
for the entire batch. At the completion of a batch 
compilation containing at least one serious source 
program error, the compiler returns control to 
SYS.1COMPER. See ACTION, above. 



CONSOLE 
TYPEWRITER 
NORMAL 
TYPE-OUTS 



2. If the operator terminates the JOB because a 

serious tape error occurred during compilation, 
the Program Tape is restored to its position at 
the start of the compilation. 

Message Explanation 

ID IS id_ Start of each compilation, where id is 

the program identity. 

ENDCOMP Compilation is complete without serious 
errors . 



nnnn CRDS nnnn is the number of cards produced 

on TSYSOUT. 
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FORTRAN 



CONSOLE 
TYPEWRITER 
ERROR 
TYPE-OUTS 



Message 

ID IS 

NO IDENTITY 



Explanation 

First non-blank card did not con- 
tain program ID. Compilation 
continues in normal manner* 



CMPERRS Compilation is complete. At least 

one source program error was 
detected. 



F4DUMP 



Machine or compiler error. Com- 
puter halts. Press ADVANCE to 
wrap up compilation. 



id TAPE POSIT. ERR. 



Machine or compiler error 
during the compiler segment 
identified by id. Computer 
halts. Press ADVANCE to 
wrap up compilation. 
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SECTION VIII 
LOADING FUNCTIONS 



The loading and initiating of program runs is the function 
of this group of control instructions. 

RPL and ABS programs are loaded in a forward sequence 
from the starting location of the program near the begin- 
ning of memory extending toward the end of memory. 
REJL programs are also loaded in a forward sequence, but 
normally into the end of memory, so that the last word of 
the program is loaded into the last word of memory. Com- 
mon storage for REL programs normally begins (as arbi- 
trarily assigned by 32KSYS) at location lOOOg and may ex- 
tend to any length required within the space available. 

ONE WORD A one -word-identity search may be used to locate a pro- 

SEARCH gram with an identity of more than eight characters. If 

this method is used, the first word must be terminated by 
a break character because trailing spaces are significant. 

For example, a program with the identity: 
PROGAAA1DATAAAA1 

appears in RPL format on T4 and has a unique first word 
of identity. The program may then be loaded by the con- 
trol instruction: 

L Location Command Address and Remarks 

RPL T4,PROGAAM$ 

The same control instruction without the dollar sign 

L Location Command Address and Remarks 

RPL T4.PROGAAA1 

results in a transfer of control to 1XCONER. The omis- 
sion of a break character indicates that the second word 
of the ID is all spaces and no match can occur. 



ft. 1 



GO 



UV executes ±Togramvs) 



FUNCTION 



FORMAT 



Executes programs, loading any programs from TSYSCR4 
that were compiled within the current JOB. 



L 


Location 


Command 


Address and Remarks 






GO 


t 



PARAMETERS 



t (OPTIONAL) - The symbolic tape containing binary sub- 
routines. 



ACTION 



If any programs were compiled onto TSYSCR4 within 
the current JOB, TSYSCR4 is rewound and all pro- 
grams on TSYSCR4 are loaded. 

If programs loaded (by previous LOAD instruction or 
from TSYSCR4) are relocatable then: 

1. Any subroutines required are loaded from U 

if t was snurififH . If t was not SDecified. 
. • _^ •- — - -| .-._.-. -- - , 

then TSYSL1B is searched. 



EXAMPLE ONE 



2. The NAME/SYMBOL list is written on the sys- 

tem output tape, TSYSOUT, edited for printing. 

Control is transferred to the program's starting address, 

• The following illustrates an RPL compilation with 
immediate execution: 



Location 



RPL 



Command 

JOB 
TAC 

(TAC lan- 
guage deck) 
GO 



Address and Remarks 



EXAMPLE 1 



ft-? 



GO 



EXAMPLE TWO 



The following illustrates multiple relocatable com- 
pilations with immediate execution: 



Location 



Command 



Address and Remarks 



JOB 
ALTAC 
(ALTAC 
language 
deck) 
TAC 

(TAC lan- 
guage deck) 
ALTAC 
(ALTAC 
language 
deck) 
GO 



EXAMPLE 2 



EXAMPLE THREE 



The following illustrates multiple relocatable com- 
pilations including the loading of previously compiled 
program decks, with immediate execution: 



Location 



Command 



Address and Remarks 



JOB 
ALTAC 
(ALTAC 
language 
deck) 
TAC 

(TAC lan- 
guage deck) 
ALTAC 
(ALTAC 
language 
deck) 
LOAD 
(binary re- 
locatable 
deck) 
GO 



EXAMPLE 3 



R- - * 



GO 

EXAMPLE FOUR • The following illustrates multiple relocatable com- 

pilations including the loading and correcting of 
previously compiled decks, with immediate execu- 
tion: 



Location Command Address and Remarks 

JOB EXAMPLE 4 

ALTAC 
(ALTAC 
language 
deck) 
TAC 

(TAC lan- 
guage deck) 
ALTAC 
(ALTAC 
language 
deck) 
LOAD 
(binary re- 
locatable 
deck) 
25P ALPHA SAMPLE 01 

LOAD 
(binary re- 
locatable 
deck) 
GO 



LOAD 



LOAD - Loads Binary Program Deck(s) 



FUNCTION 



Loads binary relocatable or absolute program deck(s) 
immediately following the LOAD control instruction, up 
to the next 32KSYS control instruction, for subsequent 
execution by a GO control instruction. 



FORMAT 



PARAMETERS 
ACTION 



Location 



Command 



LOAD 



Address and Remarks 



NONE 

If any programs were compiled onto TSYSCR4 within the 
current JOB, TSYSCR4 is rewound. All program decks 
immediately following the LOAD control instruction are 
loaded until a 32KSYS control instruction is encountered. 



REMARKS 



The LOAD instruction must be used in conjunction with 
the GO instruction when loading relocatable decks because 
binary subroutines are not loaded and the edited NAME/ 
SYMBOL list is not written on TSYSOUT until a GO is en- 
countered. 



EXAMPLES 



See GO (Examples 3 and 4, 
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ABS 



ABS - ABS Loader Call 



FUNCTION 



Locates and loads an ABS program 



FORMAT 



REMARKS 



Location 



Command 



ABS 



Address and Remarks 



t, jd, g_£, i_ 



The parameters and action are the same as those for the 
RPL control instruction except for the following: 

1. The program designated by id is presumed to be in 
ABS format. 

2. An asterisk, TSYSIN, or an 8 may be used as the 
first parameter in the ABS control instruction, if a 
binary absolute deck of the program to be loaded 
follows the control instruction. Input must be via 
magnetic tape in IMAGE MODE. 



EXAMPLE 



L Location Command Address and Remarks 

ABS *.,GO 



Explanation: Execution of this instruction causes the 
deck of binary cards which follows the instruction on 
TSYSIN to be loaded into memory. After the program 
is loaded, control is transferred to the program's start- 
ing address. The absence of the second parameter is 
indicated bv a comma. 
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REL 



REL - REL Loader Call 



FUNCTION 



Locates and loads a REL program. 



FORMAT 



L 


Location 


Command 


Address and Remarks 




m 


REL 


t\, id, go, list, subs, 
t2 • • • • *fi 



PARAMETERS 



m (OPTIONAL) - The loading address of the program. 

tj - The symbolic tape containing the REL program to be 
loaded. TSYSIN is excluded if input is in code mode. 

An asterisk (*) is equivalent to TSYSIN. 

id - The program identity. If omitted, the first REL pro- 
gram found will be loaded. 

The id parameter may be omitted if tj is an asterisk 
(*), TSYSIN or 8. ~~ 

gjo (OPTIONAL) - Indicates immediate or delayed running 
of a program. If GO is written, control will be trans- 
ferred to the program's starting address immediately 
following successful completion of the loading process. 
If the parameter is omitted, 32KSYS will save the 
starting address and will execute the next control in- 
struction. A subsequent 32KSYS "JMP*" control in- 
struction may be used to transfer control to the pro- 
gram's starting address (refer to JMP, Special Func- 
tions). 

list (OPTIONAL) - This parameter, written as LIST, in- 
dicates that all program SYMBOUTS and REFOUTS 
which have been placed in the NAME/SYMBOL list up 
to and including this loading are to be edited for print- 
ing and written on TSYSOUT immediately, before 
transferring control to the program ("GO" or "JMP"). 
If the specified program is not loaded successfully, 
the NAME/SYMBOL list, if any, will be processed as 
above, regardless of whether or not LIST was speci- 
fied. 
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REL 



subs (OPTIONAL) - This parameter, written as SUBS, 
indicates that the library tape(s) will be searched 
for required subroutines to be loaded if there are 
any undefined symbols remaining at the completion 
of the loading process. 

SUBS V t£^ , t n - 1-7 symbolic tapes which designate 

the libraries containing binary subroutines that may 
be used by the program just loaded. 

Tapes are searched in the o rde r lis ted in the parame- 
ters. 

ACTION The action is the same as that for the RPL control instruc- 

tion except for the following: 

• The program id is presumed to be REL format. 

• If undefined symbols still exist following loading of 
the designated subroutines from the library tape(s) 
and GO is specified, the NAME/SYMBOL list will be 
edited and placed on TSYSOUT for printing. Control 
will then be transferred to 1XCONER. 

Note: Binary library tapes must contain a sentinel 

block of W/ZZZZZZZZ following the last 
subroutine. 

• If there are undefined symbols, the SUBS parameter 
is not specified, and GO is specified, the same 
error procedure as above will occur. 

• If a symbol is defined more than once, it will not be 
considered an error unless the symbol is referenced. 

• The unique symbol LOADSETS. AVAILMEM has a 
special definition. If it appears first as a referenced 
symbol, it is immediately defined as being the loca- 
tion one less than the origin of the program just loaded. 
This origin is then reduced by one to preserve the lo- 
cation. If this symbol appears first as a defined sym- 
bol, that definition is given to it. (Refer to special 
function PORIG.) 

• If location LOADSETS. AVAILMEM appears on the 
NAME/SYMBOL list, its left and right address por- 
tions, respectively, will contain, after loading, the 
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REL 



REMARKS 



sum of Common origin and the size of Common, and 
the address of the smallest program origin greater 
than zero. (Refer to SEGMENT and MASTER, Seg- 
mentation. ) 

• If the LIST parameter is specified, the NAME/ 

SYMBOL list will be edited and placed on TSYSOUT 
for off-line printing. 

1. Before control is given to the loaded REL prograrn(s) 
the NAME/SYMBOL list is cleared. 

2. REL programs are loaded in a forward sequence, nor- 
mally into the end of memory or contiguous with the 
last REL program loaded. However, if a loading ad- 
dress is specified, the REL program is loaded forwar 
beginning at m. 

3. m must be greater than lOOOlg. 

4. If the source (t) of a REL program is specified as 
TSYSIN or *, the program must immediately follow 
the REL control instruction and must be in image 
mode. 



EXAMPLE ONE 



This example illustrates the loading of a single REL pro- 
gram. 



Location Command Address and Remarks 



REL 



4, TRAJ, GO, LIST, SUBS, 
LIBC.LIBA 



Explanation: Execution of this instruction causes the REL 
program TRAJ, to be loaded into the end of memory from 
the tape assigned to the system program unit number 4. 

Subroutines required to satisfy undefined program 
symbols are to be loaded first from I.IEC, then 
LIEA. TSYSLIB will not be searched, since it was 
not specified. 
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REL 



EXAMPLE TWO 



This example illustrates the joint loading of two REL pro- 
grams. 



Location Command Address and Remarks 



REL 
REL 



4,DIFF1$ 

4,DIFF2,GO,LIST, 

SUBS 



Explanation: Execution of these instructions causes the 
REL program, DIFF1 to be loaded from the tape assigned 
to the system program unit 4, into the end of memory and 
a second REL program, DIFF2, to be loaded into memory 
adjoining DIFF1. Subroutines required by either program 
to satisfy undefined symbols are to be loaded from 
TSYSLIB. When both programs and all subroutines are 
loaded, the NAME/SYMBOL list is edited and placed on 
TSYSOUT for off-line printing. Control is then trans- 
ferred to the starting address of DIFF2. 

Note: For making corrections to relocatable binary 

programs, refer to REMARK 2 of OCT, De- 
bugging Functions. 



EXAMPLE THREE 



Location Command Address and Remarks 



245P 



REL 

PORIG 

ALPHA 

JMP 



TSYSCR4, JOE, , , SUBS 

JOE 

PROGRAMA 



Explanation: Execution of these instructions causes pro- 
gram JOE to be loaded from the tape assigned to 
TSYSCR4 with subroutines. However, since the ALPHA 
correction is to be made to JOE and the P-counter is set 
to the last program loaded (a subroutine) the command 
PORIG (Special Functions) must be given before the 
ALPHA command, 



R-in 



RPL 



RPL - RPL Loader Call 



FUNCTION 



Locates and loads an RPL program. 



FORMAT 



PARAMETERS 



ACTION 



REMARKS 



Location 



Command 



RPL 



Address and Remarks 



t, id, go, i 



-L 



t_- The symbolic tape containing the RPL program to be 
loaded. 

id - The program identity. If omitted, the first RPL 
found will be loaded. 

go (OPTIONAL) - Indicates immediate or delayed running 
of program. If GO is written, control is to be trans- 
ferred to the program's starting address immediately 
following successful completion of the loading process. 
If the parameter is omitted, 32KSYS saves the start- 
ing address and executes the next control instruction. 
A subsequent 32KSYS "JMP" instruction may be used 
to transfer control to the program's starting address. 
(Refer to JMP, Special Functions.) 

HOPTIONAL) - An octal number to be added to the normal 
loading addresses of the program being loaded. 

e t_is searched forward for program id until id is found 
either as an RPL identifier, or as one of the ID's in- 
cluded in an index block, or, until a sentinel block of 
Z's is found. If id is found in an index block, or the 
sentinel block is encountered, the tape is searched 
backward. If id is still not found, control will be 
transferred to 1XCONER. 

e When the designated program is located, it is loaded 
into memory. 

e If GO is not specified, control will be transferred to 

1NXTCON. 

e If GO is specified, control will be transferred to the 
program's starting address. 



1. 



If t_is specified as TSYSIN, exit will be made to 
1XCONER. 
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RPL 



modification by i^is less than 1000G 8 , exit will be 
made to 1XCONER. 



EXAMPLE ONE 



This example illustrates the use of an RPL call with the 

program to be executed immediately. 



L Location Command Address and Remarks 



RPL 



T4 , SOLOMON23 , GO 



Explanation: Execution of this instruction causes RPL 
program SOLOMON23 to be loaded from tape T4 and con- 
trol to be transferred immediately to its starting address. 



EXAMPLE TWO 



This example illustrates the use of an RPL call with de 
layed execution of the program. 



Location 



Command 



B PT 



JMP 



Address and Remarks 

4.SOLOMON23 
(Other SYS control 
instructions) 

* 



Explanation: Execution of these instructions causes RPL 
program SOLOMON23 to be loaded from the tape assigned 
to the system program unit number 4. When the 32KSYS 
"JMP *" control instruction is encountered, control will 
be transferred to the program's starting address. 
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SECTION IX 



SEGMENTATION FUNCTIONS 



SEGMENTATION 
PROCESS 



LOADING 

SEGMENTED 

PROGRAMS 



Two 32KSYS control instructions, SEGMENT and MASTEF 
provide the facilities for dividing a relocatable binary pro 
gram, too large to be run with available memory, into 
smaller segments. Each of these segments may then be 
contained individually in the memory area. 

The segmentation process generates segments by writing 
one or more program components (which are loaded as a 
single unit into memory) onto magnetic tape in RPL forma 

The segmentation process takes place in three phases: 
first, the compilation of components as individual smaller 
programs in REL format; second, the generation of seg- 
ments in RPL format; and third, the loading and running 
of the segmented program in RPL format. The 32KSYS 
control instructions SEGMENT and MASTER are used in 
the seconu phase. 

When segments are used in a running program, they may 
be independent of one another, or they may contain cross- 
references. If they are independent, they may be gener- 
ated one at a time during the second phase of the segmen- 
tation process. If any contain cross-references, the ref- 
erencing must be done either via the Common area of 
memory or via a Master segment which is contained in 
memory during the generation of all segments. 

The SEGMENT instruction generates segments by writing 
the components just loaded onto magnetic tape. The 
MASTER control instruction is used to indicate that the 
component(s) just loaded are to form a Master segment, 
and are to remain in memory during the generation of 
succeeding segments. 

Program segments may be loaded by the 32KSYS internal 
loader, which may be called by either of the following 
methods: 



Q-l 



Via the 32KSYS Generator LOADGEN (Library Rou- 
tines), which will create the necessary TAG language 
coding. 

Via the 32KSYS entry 1 INTLD (32KSYS Entries), 
which provides a transfer of control to the internal 
loader during the running of the program. 



SEGMENT 



SEGMENT - Defines a Program Segment 



FUNCTION 



Causes program components loaded into memory in REL 
format to be written as a segment onto magnetic tape in 
RPL format. 



FORMAT 



L 


Location 


Command 


Address and Remarks 






SEGMENT 


t, id, master 



PARAMETERS 



t_- The symbolic tape onto which the segment is to be 
written. If TSYSTEM or TSYSOUT is designated, 
exit will be made to IXC ONER. 



ACTION 



id - 16 or fewer alphanumeric characters which will be the 
identity of this particular segment. Spaces are sig- 
nificant. 

master (OPTIONAL) - A parameter written as MASTER 
which enables a Master segment to be written on tape. 

Execution of a SEGMENT control instruction initiates the 
following actions: 

e Examines the NAME/SYMBOL list associated with the 
particular segment of the program to determine if 
there are any undefined symbols. Undefined symbols 
cause exit to 1XCONER. 



Writes the portion of memory between the most re- 
cent program origin (set by REL loader) and the be- 
ginning of the Master Segment, if a Master segment 
has been defined, onto t_in RPL format. If a Master 
segment has not been defined, that portion of memory 
between the most recent program (set by REL loader) 
and the end of memory will be written onto t. 

Writes a sentinel block of Z's onto t_ following the seg- 
ment, and positions the tape at the beginning of this 
block. If another segment is to follow, it will be writ- 
ten over the sentinel block and a new sentinel block 
will be written following the new segment. This pro- 
cedure is repeated for all segments, including the 
Master segment, thus insuring the presence of a 
sentinel block after the final segment only. 

9- 3 



SEGMENT 
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REMARKS 



EXAMPLE ONE 



• Clears to fixed-point zeros that portion of memory 
occupied by the segment after the segment is written 
onto t. 

• Clears the NAME/SYMBOL list of all names and 
symbols defined by the particular segment, excluding 
the Master segment list, if used. 

• Writes onto t in FPL forms t that area between the 
beginning of one Master segment and the beginning 
cf the next (or the end of memory, if only one 

mester segment is in memory), if the master parameter 
is used. In addition, it clears the memory area and 
the NAME/SYMBOL list used by tnat Master Segment. 

Symbolic Location LOADSETS. AVAILMEM may be defined 
in every segment if it is not defined in 'amy associated Master 
segment . 

This example illustrates the use of SEGMENT without a 
master parameter. Assume that the first segment (SEG 1) 
of a large program consists of components PROG 1 and 
PROG 2, and that these components are in REL format on 
the tape assigned to system program unit numuer -r. 



Location 



Command 



Address and Remarks 



REWIND 
REL 
REL 
SEGMENT 



4, PROG 1 

4, PROG 2, , LIST, SUBS 

6, SEG 1 



Explanation: Execution of these instructions causes the 
two components to be loaded and written in RPL format 
onto the tape assigned to system program unit number 6. 
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EXAMPLE TWO 



SEGMENT 

This example illustrates the use of SEGMENT with the 
master parameter. Assume that EXEC, SUBEXEC1, 
and SUBEXEC2 are Master segments. APROG. BPROC, 
CPROG, and DPROG each constitute segments. 

L Location Command Address and Remarks 



REWIND 

REL 

MASTER 

REL 

MASTER 

REL 

SEGMENT 

REL 

SEGMENT 

SEGMENT 

REL 

MASTER 

REL 

SEGMENT 

REL 

SEGMENT 

SEGMENT 

SEGMENT 



4, EXEC, , LIST, SUBS 

4, SUBEXEC1, , LIST, SUBS 

4, APROG, , LIST, SUBS 

6.SEG1A 

4, BPROG, , LIST, SUBS 

6, SEG1B 

6, SEG1, MASTER 

4, SUBEXEC2, , LIST, SUBS 

4, CPROG, , LIST, SUBS 

6, SEGZA 

4, DPROG, , LIST, SUBS 

6.SEG2B 

6, SEG2, MASTER 

6, EXEC, MASTER 



Explanation: Execution of these instructions causes the 
six segments to be written in RPL format onto the tape 
assigned to system program unit number 6. The RPL 
6, EXEC, GO causes the overall program to be run. 
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MASTER 



MASTER - Defines a Master Segment 



FUNCTION 



FORMAT 

PARAMETERS 
ACTION 



REMARKS 



EXAMPLE 



Indicates to 32KSYS that. (1 ) a segmenting process using 
a Master segment is about to take place, and (') a Master 
segment consisting of one or more REL components has 
been loaded and is to remain in memory during the forth- 
coming loading and writing of the various segments. The 
Master segment remains in memory during segmentation 
so that symbolic cross - references may be made with 
succeeding segments associated with it. 



L 


Location 


Command 


Address and Remarks 






MASTER 





None 



Stores the Master segment's starting address in a list. 
This address is taken from the last relocatable END card 
of a Master component to be loaded that contains a start- 
ing address. If no component contains a starting address, 
zero will be stored. 

1. If a MASTER control instruction is given, control 
may be transferred to a Master segment still in 
memory by the use of a " JMP* " control instruction, 
if the Master segment has not been written. 

2. Each additional MASTER control instruction forces 
information about the preceding Master segment 

to be stored in a push-down list in memory. This 
information is restored when the succeeding Master 
segment is written out. 

3. Refer to REMARKS of SEGMENT. 

Assume that the Master segment consists of two compo- 
nents in relocatable binary format with ID's of EXEC1 
and EXEC2, both contained on the tape assigned to sys- 
tem program unit number 4. 

L Location Command Address and Remarks 



JOB 
REL 
REL 
MASTER 



XRAY 

4, EXEC1 

4, EXEC2, , LIST, SUBS 
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MASTER 



Explanation: Execution of thai* instructions causes the 
two components to be loaded into memory, forming a 
Master segment and retaining the segment in memory 
until all other segments are loaded and written onto tape. 
The starting address of the Master segment is one of the 
following: 

• The starting address of EXEC1, if EXEC2 has no 
starting address. 

e The starting address of EXEC2, if it contains a 

starting address. EXEC2 takes precedence because 
it is the last to be loaded. 

• Zeros, if neither EXEC1 nor EXEC2 contain a start- 
ing address. 

Note: TAC library subroutines never contain 
starting addresses. 
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SECTION X 
TAPE HANDLING FUNCTIONS 

This group of control instructions is con- 
cerned specifically with magnetic tape oper- 
ations. These operations include rewinding 
tapes, reading tapes forward and backward, 
writing on tapes, locating on tapes, writing 
sentinels, and locating sentinels. 32KSYS 
XORD is used for all tape movements by 
these control instructions. 
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REWIND 



REWIND ~ Rewinds Magnetic Tape 



FUNCTION 



FORMAT 



PARAMETERS 



ACTION 



Rewinds magnetic tapes, 



L 


Location 


Command 


Address and Remarks 






REWIND 


t, ... , t_ 



t - The symbolic tape to be rewound, 
t t are rewound. 
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REWINDLO 



REWINDLO - Rewinds Magnetic Tape with lockout 



FUNCTION 



Rewinds magnetic tapes with lockout. 



FORMAT 



L 


Location 


Command 


Address and Remarks 






REWINDLO 


I j • • • i £ 



PARAMETERS 



t - The symbolic tape to be rewound with lockout. 



REMARKS 



Operators are instructed that any tape rewound with 
lockout is subject to removal. 



ACTION 



Program unit numbers and all names associated with 

t, ,t are released from their specific assignments 

by removing the names from the tape name list. 
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READF 



READF - Reads Magnetic Tape Forward 



FUNCTION 



Spaces forward and/or reads blocks forward from a 

specified magnetic tape into memory. 



FORMAT 



PARAMETERS 



ACTION 



L 


Location 


Command 


Address and Remarks 






READF 


t, nbs, nbp, addr 



t - The symbolic tape to be spaced and/or read for- 
ward. 

nbs (OPTIONAL) - The number (decimal) of blocks to be 
spaced forward. If nbp below is omitted, nbs must 
be specified. 

nbp (OPTIONAL) - The number (decimal) of blocks to 
be read forward. If nbs i« omitted nbp must be 
specified. 

addr (OPTIONAL) - The address into which the data 
on the tape is to be read. If nbp is omitted or is 
zero, addr may be omitted. 

t is spaced forward nbs number of blocks, and nbp 
number of blocks are read into memory beginning at 
addr. 



EXAMPLE ONE 



This example illustrates the use of a space-read 
command. 



L Location Command Address and Remarks 



READF 



6, 2, 5, 15000 



EXAMPLE TWO 



Explanation: Execution of this instruction causes the 
tape assigned to system program unit number 6 to be 
spaced forward two blocks, and the next five blocks 
to be read into memory starting at location 15000g. 

This example illustrates the use of a read-only 
command . 



READF 



L Location Command Address and Remarka 

READF T-024. , 36, 25000 

Explanation: Execution of this instruction causes 36 
blocks of T-024 to be read into memory starting at 
location 25000g . No spacing of blocks is to take 
place prior to the read. 

EXAMPLE THREE This example illustrates the use of a space -only 

command. 

L Location Command Address and Remarks 

READF T-023, 160 

Explanation: Execution of this instruction causes T-023 
to be spaced forward 160 blocks. No reading is to take 
place 



in-«; 



READB 



READB - Reads Magnetic Tape Backward 



FUNCTION 



FORMAT 



REMARKS 



EXAMPLE 



Space backward and/or reads blocks backward from a 
specified magnetic tape into memory. 



Location 



Command 



READB 



Address and Remarks 



t ; nbs, nbp, addr 



The parameters, action, and remarks concerning READB 
are the same as those for the READF instruction except 
that spacing and/or reading is performed backward on 
the tape. 



Location Command 



Address and Remarks 



READB 



TSYSCRO, 5, 10, 32000 



Explanation: Execution of this instruction causes 
TSYSCRO to be spaced backward 5 blocks, and the 
next 10 blocks to be read backward into memory start- 
ing at location 32000g . 
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WRITE 



WRITE - Writes on Magnetic Tape 



FUNCTION 



FORMAT 



PARAMETERS 



Spaces forward and/or writes a specified number of 
blocks from memory onto an output magnetic tape. 



L 


Location 


Command 


Address and Remarks 






WRITE 


t, nbs, nbp, addr 



t - The symbolic tape to be spaced forward and/or 
written upon. 

nbs (OPTIONAL) - The number (decimal) of blocks to 
be spaced forward. If nbp below is omitted nbs 
must be specified. ™~ ~~ 

nbp (OPTIONAL) - The number (decimal) of blocks to be 
written. If nbs is omitted, nbp must be specified. 

addr (OPTIONAL) - The address from which data is to 
be written. If nbp is omitted or is zero, addr may 
be omitted. ~~ ~~ 



REMARKS 



EXAMPLE 



The remarks and action for the WRiTE control instruc- 
tion are the same as those for the READF instruction 
except that writing onto tape rather than reading from 
tape is performed. 

L_ Location Command Address and Remarks 



WRITE 



3, 3, 6, 17500 



Explanation: Execution of this instruction causes the 
tape assigned to system program unit number 3 to be 
spaced forward three blocks, and the next six blocks 
to be written starting from location 17500 g . 
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LOCSENT 



FUNCTION 



FORMAT 



PARAMETERS 



LOCSENT - Locates a Sentinel on Magnetic Tape 

Searches forward on a tape for a sentinel block which 
contains a designated sentinel as each of the first 120 
words. 



Location 



Command 



LOCSENT 



Address and Remarks 



t, sent 



t - The symbolic tape to be searched. 

sent (OPTIONAL) - The sentinel word. If omitted, 
Z's are assumed. 



ACTION 



EXAMPLE 



• t is searched forward for a sentinel block with 
"sent as each of its first 120 words. 

• When the designated sentinel block is found, t is 
positioned immediately past the sentinel block. 

• If the sentinel is not found, the computer will 
encounter a serious tape error. 

L Location Command Address and Remarks 

LOCSENT 6, ZZZZZZZZ 

Explanation: Execution of this instruction causes the 
tape assigned to program unit number 6 to be searched 
forward for a sentinel block which contains all Z's 
in the first 120 words. After the sentinel block is 
located, the tape is positioned immediately past the 
block. 
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LOCABS, LOCRPL, 
LOCTACL,LOCREL 



LOCABS, LOCRPL, LOCTACL, LOCREL - Locates 
a Program on Magnetic Tape 



FUNCTION 



FORMAT 



PARAMETERS 



ACTION 



EXAMPLE ONE 



Searches a tape for specified TAG language, RPL, 
ABS or REL programs. 



L 


Location 


Command 


Address and Remarks 






LOCABS 
LOCTACL 
LOCREL 
LOCRPL 


t, id, sent 
t, id, sent 
t, id, sent 
t, id, sent 



t - The symbolic tape to be searched. 

id - The program to be located. 

sent (OPTIONAL) - The sentinel word. If omitted, 
Z's are assumed. 

• Ms searched forward for program id until either 
id is located or a sentinel block of sent is en- 
countered: If the sentinel block is encountered 
prior to the id, the tape will be searched back- 
ward. If the id is still not found, exit will be 
made to 1XCONER. (If LOCRPL, refer also to 
RPL, Loading Functions). 

• After the designated program is located, the tape 
is positioned immediately prior to the first block 
of the program. 

Assume that Tape T-024 contains the following TACL 
programs: 

PART 1 

PART 2 040162 

PART 3 041062 



i^o< 



^iuuTCSS aiXG K6iu3.rK8 



LOCTACL T-024, PART 3 041062 
LOCTACL T-024, PART 3$ 



l n.Q 



LOCABS, LOCRPL, 
LOCTACL, LOCREL 



EXAMPLE TWO 



Explanation: Execution of either of these instructions 
causes the third program on the tape to be located. 

Assume that Tape ALPHA contains the following RPL 
programs: 

PART 1 

PART 2 040162 

PART 3 041062 

L Location Command Address and Remarks 

LOCRPL ALPHA, PART 3 041062 
LOCRPL ALPHA, PART 3$ 

Explanation: Execution of either of these instructions 
causes the third program on the tape to be located. 
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WRTABS 



WRTABS - Writes on Magnetic Tape in ABS Format 



FUNCTION 



Writes words between designated memory locations 
onto magnetic tape in absolute binary card (ABS) for- 
mat and assigns a program identity to the data written 
as the new ABS program. 



L 


Location 


Command 


Address and Remarks 


z 




WRTABS 


t. id, addrj , addr£ . 
"addr 3 , _£ 



PARAMETERS 



* (OPTIONAL) - The character Z- which indicates that 
every word (including fixed point zeros) in the pro- 
gram will be written onto t. If omitted, leading 
words of zeros will be omitted from each absolute 
binary card produced. If trailing words of zeros are 
present, they will be included to complete a card. 

£ - The symbolic tape on which the data in ABS card 
format is to be written, 

id - The identity of the new ABS program. The first 
four characters of id are used to provide an ID in 
Hollerith code for Columns 1-4 of the ABS card 
output. 



addr i (OPTIONAL) - The first address from which 
information is to be written on tape. If omitted, 
addrj will be program origin (set only by REL 
loader). 

information is to be written on tape. If omitted, 
addr 2 will be effective end of memory +1. 

addr 3 (OPTIONAL) - The starting address of the new 
ABS program. An asterisk (*) indicates that the 
address stored in 1NTRYJA will be used. ( 1NTRYJA 
normally contains the address of a location in the 
current object program to which control is to be 
transferred from 32KSYS). If omitted, addr . will 
be used. 



m_n 



WRTABS 



ACTION 



i (OPTIONAL) - An octal number to be added to addr j 
when the loading address of the new ABS program 
is formed. The number is also added to addr ^ 
to form the program starting address. The addi- 
tion of the values takes place modulo machine size. 



All information between addr ^ and addr ? 
written onto t in absolute binary card (ABJ 



will be 
:y card iaBS) format. 
If Z is written as the z parameter, words of zeros 
will also be included in the output. 



Two sentinel blocks of Z's are written on the out- 
put tape following the new ABS program. 

t is positioned immediately prior to the first block 
of Z's. 

The message: id ORIGIN addr j n CARDS will be 
written on TSYSOUT. 

ID is id n CARDS is typed if the ABS program is 
written" on TSYSOUT. 



EXAMPLE ONE 



This example illustrates the use of WRTABS without an 
offset address. 



Location Command 



WRTABS 



Address and Remarks 

T-024, JACKSON, 20000, 
30000$ 



Explanation: Execution of this instruction causes the 
contents of all memory locations from 20000g to 30000 g, 
except words of zeros, to be written in absolute binary 
format onto tape T-024. The program identity of the 
new ABS program is JACKSON. 

The address specified by addr j, 20000 g, is to be used 
as the starting address for the ABS program, as addr , 
is omitted. Two sentinel blocks of Z's are written 
following the new ABS program, and the tape is positioned 
immediately prior to the first block of Z's. 



EXAMPLE TWO 



This example illustrates the use of WRTABS with an 
offset address. 
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WRTABS 

L Location Command Address and Remarks 

Z WRTABS ALPHA, ABLE, 20000 

25000, 22000,600 

Explanation: Execution of this instruction causes the 
contents of all memory locations from 20000 g to 
25000 g including words of zeros, to be written in 
absolute binary format onto tape ALPHA. The program 
identity of the new ABS program is ABLE. The location 
into which ABLE is to be loaded is 206008- The starting 
address of the new ABS program is to be 22600 8- Two 
sentinel blocks of Z's are written following the new ABS 
program, and the tape is positioned immediately prior 
to the first block of Z's, 

EXAMPLE THREE This example illustrates the use of WRTABS with 

TSYSOUT(5) as the output tape. 

L Location Command Address and Remarks 

Z WRTABS 5.GOODCHEER, 16000, 

22000 

Explanation: Execution of this instruction causes the 
contents of all memory locations from 16000 g, to 
22000 8. including words of zeros, to be written in 
absolute binary format onto TSYSOUT, The program 
identity of the new ABS program is GOOD CHEER, The 
address specified by addrj , 160008. is to be used as 
the starting address for the ABS program, as addr -^ is 
omitted. WRTABS transfers binary card images to 
this tape for off-line punching in Data Select 1, Image 
Mode (20 words per card, six cards per block). 
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WRTRPL 



WRTRPL - Writes on Magnetic Tape in RPL Format 



FUNCTION 



Writes words between designated memory locations 
onto magnetic tape in RPL format and assigns a 
program identity to the data written as a new RPL. 



FORMAT 



L 


Location 


Command 


Address and Remarki 






WRTRPL 


t, id, addr, , addr ? , addr^.i 



PARAMETERS 



t - The symbolic tape excluding TSYSOUT, on which 
the RPL is to be written. 

id - The identity of the new RPL. 



addr j (OPTIONAL) - The first address from which 
information is to be written on tape. If omitted, 
addr i will be programmed origin (set only by 
REL loader). 



addr ^ (OPTIONAL) - An address from which information 
is to be written on tape. If omitted, addr 2 w ^ De 
the effective end of memory + 1. 



ACTION 



addr 3 (OPTIONAL) - The starting address of the RPL 
program. An asterisk (*) indicates that the address 
stored in 1NTRYJA will be used. (1NTRYJA normal- 
ly contains the address of a location in the current 
object program to which control is to be transferred 
from 32KSYS). If omitted, addr j will be used. 

2 (OPTIONAL) - An octal number to be added to addr , 
when the loading address of the new RPL program 
is formed. The number is also added to addr , to 
form the program starting address. The addition of 
the value takes place modulo machine size. 

• All information between memory locations addr, 
and addr 2 will be written on t_ in RPL with a 
program identity of id. 



Two sentinel blocks of Z's are written on Tape t. 
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WRTRPL 



t is positioned immediately prior to the first block 
of Z's. 



The message: 



RPL 

id 



ORIGIN 
RPL 



addr 

n BLOCKS 



EXAMPLE ONE 



will be written on TSYSOUT. 

This example illustrates the use of WRTRPL without 
an offset address, following a REL load, and using sym- 
bolic addresses for addr , and addr-, . 



Location Command 



Address and Remarks 



2000 



REL 4, D1FF 

WRTRPL ALPHA, GOODBYE, 

DIFF.START, 

DIFF„END 



EXAMPLE TWO 



Explanation: Execution of the REL instruction cause 
the REL program D1FF to be loaded into memory starting 
at location ZOOOOg from the tape assigned to system pro- 
gram unit 4„ Execution of the WRTRPL instruction 
causes the contents of memory locations from DIFF„ 
START to DIFF„END to be written in RPL format onto 

Tang AT.PHA wit-Vi ^n Tr» r>* nr>r"» rm V IT i-ittt ir ctadt-' 

and DIFF,END are defined by the REL loader in the 
NAME/SYMBOL list if TAC SYMBOUT instructions at 
compile time, or a 32KSYS SYMDEF instruction at run 
time, permit recognition of the symbols. If the symbols 
are not defined, control will be transferred via 
1XCONER. D1FF C START will be used as the starting 
address for the RPL since addr., is omitted. Two 
sentinel blocks of Z's are written following the new 
RPL on Tape ALPHA then ALPHA is repositioned im- 
mediately prior to the first block of Z f s. 

ThiB example illustrates the use of WRTRPL with an 
offset address. 



L Location Command Address and Remarks 



i.x\sr±^ 1-0Z3, HELLO, 2uuuu, 

25000, 22000, 325$ 

Explanation: Execution of this instruction causes the 
contents of memory locations from 20000g to 25000 g 



WRTRPL 



to be written in RPL format onto Tape T-023. The 
program identity of the new RPL is HELLO. The 
location into which HELLO is to be loaded is 20325 8 . 
The starting address of the new RPL is to be 22325 g . Two 
sentinel blocks of Z's will be written following the" 
new RPL; then the tape will be positioned immediately 
prior to the first block of Z's. 
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WRTSENT 



WRTSENT - Writes a Sentinel on Tape 



FUNCTION 



Writes a sentinel block of 128 words of a designated 
configuration onto a specified magnetic tape. 



FORMAT 



L 


Location 


Command 


Address and Remarks 






WRTSENT 


t, sent 



PARAMETERS 



ACTION 



EXAMPLE ONE 



EXAMPLE TWO 



£ - The symbolic tape to be written upon, 

sent - The sentinel word to be used as each of the 128 
words of the sentinel block, 

A sentinel block of 128 words of sent is written onto t, 
t_ remains positioned following the sentinel, - 

This example illustrates the use of a WRTSENT command 
with an eight-character sentinel. 

L Location Command Address and Remarks 

WRTSENT 6, ZZZZZZZZ 

Explanation: Execution of this instruction causes a 
sentinel block containing 128 words of Z's to be written 
onto the tape assigned to system program unit number 
6, 

This example illustrates the use of a WRTSENT command 
with a sentinel of fewer than eight characters. 

L Location Command Address and Remarks 



WRTSENT NINE, XXX 

Explanation: Execution of this instruction causes a 
sentinel block containing 128 words of 00000XXX to be 
written onto symbolic tape NINE. 
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SECTION XI 
DEBUGGING FUNCTIONS 



Various control instructions within the Philco Operating 
System aid the programmer during the debugging of his 
program. DUMP and SNAP instructions provide two 
methods of obtaining information stored within various 
parts of memory via the High Speed printer. Three other 
instructions, OCT, CMD, (COMMAND), and ALPHA, per- 
mit replacement of a word in memory in octal, command, 
and alphanumeric representation, respectively. 

The post-mortem dumping of the DUMP control instruc- 
tion takes place in three stages. The first, or pre-dump 
stage, which takes place whenever a DUMP control in- 
struction is encountered by 32KSYS, stores information 
concerning the dump request within the dump table in 
memory. The second, or intermediate stage, copies bi- 
nary data from memory to TSYSDMP. The third, or con- 
version phase, edits the memorv specified bv- the dumn 
table in the specified format and transfers the edited in- 
formation to TSYSOUT. 

The latter two stages will take place only if a post-mortem 
dump is initiated. (Refer to 1ZERO, 1ERRDMP, and 
1SUBERR. ) The dumping process for the SNAP control 
instruction differs from that of the DUMP instruction only 
in that the data from the location(s) to be snapped is trans- 
ferred to TSYSDMP during the running of the program. 
The unedited data on TSYSDMP is edited to TSYSOUT if 
control is transferred to 1ZERO, 1ERRDMP, 1SUBERR, 
1ENDJOB, 1NXTCON, 1XCONER or Location 1 (operator 
action only), or during a CLOBDMP procedure, 
provided TWYSDMP has not been rewound. 



DUMP 



FUNCTION 



FORMAT 



DUMP - Dumps Memory 

Specifies what information is to be edited for the High- 
Speed Printer in a post-mortem dump. 



L 


Location 


Command 


Address and Remarks 






DUMP 


format, addrj, addr2 



PARAMETERS 



REMARKS 



format - The format in which information within the speci- 
fied memory locations is to be dumped. 

A Alphanumeric Conversion 

C Command Conversion 

F Floating Point Conversion 

H Hexadecimal Conversion 

O Octal Conversion 

nS Fixed Point Conversion 

n (OPTIONAL) - A decimal number, through 47, which 
~ indicates the position of the binary point. If n is 
omitted, will be assumed. 

addrj - The starting address of the area to be dumped. 
(Refer to SYSOPS8.) 

addr2 - The ending address of the area to be dumped. 
(Refer to SYSOPS 8. ) 

1. If an illegal parameter is used, if any parameter is 
omitted, or if addr z is less than addr j, the DUMP 
card is ignored. 

2. A post-mortem dump occurs whenever control is 
transferred to 1ERRDMP, 1SUBERR, or 1ZERO. 

3. DUMP control instructions should normally appear 
prior to the instruction which initiates the running 
of a program. Information specified by the parame- 
ters is saved by 32KSYS until a new JOB instruction 
is encountered. 

4. A maximum of ten DUMP instructions may be speci- 
fied. Any DUMP instruction in excess of ten will be 
ignored. 
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DUMP 



5. Semi-colons or commas may be used interchangeably 
as break characters in the DUMP card. 

6. DUMP cards containing errors are ignored and an 
appropriate error message is written on TSYSOUT. 



EXAMPLE ONE 



Location Command 



DUMP 



Address and Remarks 



O, 11000, 17000 



Explanation: Execution of this instruction causes the dump 
routine to be preset to execute a dump from location 110008 
through 17000s in octal format. 



EXAMPLE TWO 



Location 



Command 



Address and Remarks 



DUMP 



A, NAME.FLAD+33, 
1400P 



Explanation: Execution of this instruction causes the dump 
routine to be preset to execute a dump, from location 
NAME.FLAD+33 through the location represented by the 
sum of 1400g and the origin of the last REL program loaded, 
in alphanumeric format. This instruction must immediate- 
ly follow the loading of the REL program which contains 
NAME.FLAD. NAME.FLAD is defined by the REL loader 
in the NAME/SYMBOL list if a TAC SYMBOUT instruc- 
tion at compile time, or a 32KSYS SYMDEF instructional 
run time, permits recognition of the symbol. 
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Revised page 4-1^ -t- 



SNAP - Snaps Memory 



FUNCTION 



Specifies what information is to be edited for the High- 
Speed Printer when designated conditions occur during 
the running of a program. 



FORMAT 



L 


Location 


Command 


Address and Remarks 


£ 


loc 


SNAP 


format;addri;addr2; 
addr3;cond 



PARAMETERS 



The parameters in the Address and Remarks field are 
separated by semi-colons. 



p - L or R, which indicates whether the left or right in- 
struction of a particular location will initiate the 
snap routine. The snap occurs prior to the execu- 
tion of the instruction. If p is omitted L will be as 
sumed. 

loc - The location containing the instruction that will 
initiate the snap routine. 

format - The format in which information within the 
specified memory locations is to be dumped. 

A Alphanumeric Conversion 

C Command Conversion 

F Floating-point Conversion 

H Hexadecimal Conversion 

O Octal Conversion 

nS Fixed-point Conversion 



n (OPTIONAL) - A decimal number, through 47, which 
indicates the position of the binary point. If n is 



omitted, will be assumed. 



iddr^ - 
iddr2 



the location of the 

first word to be 

dumped. 

the locstion of the 

Isst word to be 

dumped . 
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addr3 (OPTIONAL) - The address of the last word in a six- 
word dump table. If no address is specified, the snap 
table will be stored in memory immediately preceding 
the last snap table. If no address is specified for any 
snap table, the first table is stored either at the end of 
memory (RPL) or (ABS), or immediately preceding 
the last program loaded (REL). It is the programmer's 
responsibility to select the appropriate locations and 
proviuc s Uiiicient space ior an nis snapsuot tauies. 

If indexed, addi^ or addi^ must be in the form: 

val, i where val is en octal number from 0-777 and i is a number fror 0-7. 



Page revised 4.-15-65 

SNAP 

cond (OPTIONAL) - The condition which must be satisfied 
before a SNAP can be executed. If omitted, a snap 
dump will take place each time the instruction is to 
be executed. 

There are two kinds of conditions: 

1. The M/N Condition 

A snapshot dump may be executed the Mth through the 
Nth time an instruction is executed where M and N are 
decimal numbers. 

2. Comparison conditions 

The Contents of a memory location or a register are 
compared in an alphanumeric sense only, to the 
contents of a memory location, a register, or 

octal value. 

The following comparisons can be made (a and b 
represent the contents of a memory location, a 
register or a value): 

a - b a equals b 

a< b a is less than b 

a .-* b a is greater than b 

a ^ b a is not equal to b 

The following rules govern the compared locations: 

a. Addresses of memory locations must be parenthe- 
sized. 

Example: (125)<5 

A snapshot dump will be given at the specified 
location when the contents of location 1258 are 
less than 5. (The value 5 is right justified with 
leading zeroes. ) 

b. The notations A, Q, and D refer to the contents 
of the A Register, the Q Resiter and the D Regis- 
ter. The notation i! n" (n=0, 1, Z--7) refers to 
the contents of index register n, right justified 
with leading zeros. When referring to the con- 
tents of a register, the parenthesesmust be omitted. 
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SNAP 



Page revised 4-15-65 



Examples 



,2> 1 



A snapshot dump will be given at the specified 
location when the contents of index register 2 are 
greater than 1. 

A# (15000) 

A snapshot dump will be given at the specified 
location when the contents of the A register are 
unequal to the contents of 150008. 

c. An address can be index modified. 



Example 



(157,4) >0 



A snapshot dump will be given at the specified 
memory location when the contents of 157g modi- 
fied by the contents of inuex register i are nega- 
tive. 

* NOTE 

REMARKS 1. The program to be run must be loaded into memory 

prior to the appearance of the SNAP control instruc- 
tion^). (SNAP calls may be compiled with a program 
through the use of the SNAPGEN generator. ) 

2. If p/loc is the same on two or more SNAP control in- 
structions, the snap routines for those instructions are 
performed in the reverse order from which they were 
submitted. SNAP instructions which specify different 
addresses need not be sequenced by address. 

3. When control is returned from the SNAP routine to the 
object program, all registers except JA are restored. 

4. There is no limit to the number of SNAP instructions 
which can be given with each job, except that sufficient 
memory space should be available for snap tables (six 
locations per call). 

5. The instruction at p/loc may not be a TIJ, TJM, TIO, 
SKC, or RPT. In addition, this instruction may not be 
under the influence of an RPT, TIO, or SKC instruc- 
tion, nor may it be program -modified (e.g., by EES 

*N0TE: Since comparisons are made in an alphanumeric sence, the condition 
A<B, WHERE B + 0, cen never be satisfied. 
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or TJM). If one of these conditions is in effect (1) the 
return from the snapshot call may be to the wrong lo- 
cation in the object program (2) a TJM may give un- 
expected results, or (3) control may be transferred 
to location Zero. 



EXAMPLE ONE 



6. Illegal SNAP cards cause an exit to 1XCONER. 

This example illustrates the use of a conditional snapshot 
dump: 



Location 


Command 


Address and Remarks 




JOB 


XYZ 




RPL 


4, ALPHA 


15260 


SNAP 


0; 0,3;i77,3;;A#0 




J MP 


* 



EXAMPLE TWO 



Explanation: Execution of these instructions causes pro- 
gram ALPHA to be loaded and run. An octal dump of lo- 
cations 0, 3 through 177, 3 will be performed before the 
execution of the instruction at 15260, if the contents of the 
A Register are non-zero. The SNAP table is situated in 
the last six memory locations at the end of memory. 

This example illustrates the use of an unconditional snap- 
shot dump: 



Location Command Address and Remarks 

14430 SNAP F;14P;30P 



Explanation: Execution of this instruction will cause an 
unconditional floating-point dump of the location repre- 
sented by the sum of 14s and the origin of the last REL 
program loaded through the location represented by the 
sum of 308 and the origin of the last REL program loaded 
to be performed prior to executing the instruction at 
14430L (L is assumed). 



OCT 



OCT - Replaces Word(s) in Octal Format 



FUNCTION 



Replaces the contents of one or more consecutive memory 
locations with words in octal format. 



FORMAT 



L 


Location 


Command 


Address and Remarks, 




loc 


OCT 





PARAMETERS 



REMARKS 



loc - The location of the word to be changed. 

word l - 16 or fewer octal digits which indicate the bit con- 
figuration to be inserted into the first location to be 
changed. If fewer than 16 characters are specified, 
the remainder of the word is right filled with zeros. 

word n (OPTIONAL) - One or more additional parameters 
in the same format as word }, to be inserted into sub- 
sequent consecutive locations. 

If corrections are to be made to relocatable programs, the 
following information should be noted: 



1. The NAME/SYMBOL list may be stored in the 
TEMPORARY/ASTOR area of a program and if nec- 
essary at the area in memory starting at lOOOOg. 
However, the symbol list is cleared prior to executing 
the program. 

2. Therefore the programmer should be especially care- 
ful when correcting the TEMPORARY/ASTOR area or 
the area starting at 100008 so as not to affect the sym- 
bol list and/or its connections. If the symbol list and/ 
or its connections are affected, 32KSYS will err when 
clearing the symbol list prior to executing the program. 

3. See explanation of PORIG if LOADSETS. AVAILMEM 
or any other modification of program origin has oc- 
curred prior to execution of CMD, ALPHA, or OCT 

corrections. 
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OCT 

EXAMPLE L Location Command Address and Remarks 

100C OCT 111111111111,222222,333 

200P OCT 444 4444444444 444, 55 

Explanation: Execution of these instructions will replace 
the contents of the memory locations listed below with the 
following information (expressed in Octal format). 



Location New Con tents 

Common +100s 12/001 
Common + 1018 6/010 

Common + 1028 3/011 

Program origin + 2008 16/100 

Program origin + 2018 2/101 






page revision 
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CMD (or COMMAND) - Replaces Program Instruction(s) 
in Command Format 



FUNCTION 



FORMAT 



PARAMETERS 



Replaces the contents of one or more consecutive uaii- 
words in memory with instructions in command format. 



Location 



loc 



Command 



CMD 



Address and Remarks 



instr j, addr j ; . .instr n 
addr n 



p - Position of the first half-word to be replaced. 



L (or blank) 
R 



Specifies the left instruction 
Specifies the right instruction 



ACTION 



REMARKS 



loc - The locstionof the first word to be replaced. 

instrj addrj - The new instruction and its address, sepa- 
rated by a comma, where: 

instri is a TAC mnemonic, and 

addri is an address. If indexed, the form must be: 
val, i where val is an octal number from 0-7777 
and i is a number from 0-7. 

instr n addr n (OPTIONAL) - One or more additional pa- 
~~~ rameters in the same format as that for instr j, addr j. 
Parameters within the CMD control line must be sep- 
arated by semi-colons. 

One or more consecutive half-words of memory, starting 
at the p half of loc, are replaced by one or more half- 
words designated by instr j, addr j; instr n , 

addr n . 

1. CMD and COMMAND may be used interchangeably as 
the call for this control instruction. 

2. If the address portion of a parameter, is omitted, the 
address field of the half-word to be replaced will be 
filled with zeros. 
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3. If the address portion of a parameter is index register 
modified, the entire parameter must contain two com- 
mas, one between the instruction portion and val and 
one between val and i. 

4. Any errors detected will cause control to be trans- 
ferred to the system via 1XCONER. 

5. Refer to OCT, REMARKS, concerning relocatable cor- 
rections. 

EXAMPLE ONE This example illustrates the use of an absolute address 

correction. 

L Location Command Address and Remarks 

R 12120 CMD TDXL, 0, 5-CM, 17677 

Explanation: Execution of this instruction causes two 
half-words contained in memory locations 121 20R, and 
12121L to be replaced by the binary representation for 
TDXL 0, 5 CM 17677. 
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CMD 

EXAMPLE TWO This example illustrates the use of a relative address cor- 

rection: 



JjUSJtlLUJIl Vj 



<"•___-*. a ~^ i/^oaqt atiH Remarks 



REL 4, CORRECT $ 

R 210P CMD JNOL, 14P;TMQ.30C 



Explanation: Execution of the first control instruction 
above causes the program CORRECT to be loaded without 
subroutines. If SUBS were specified, the origin used for 
the corrections would be that of the last subroutine loaded 
rather than that of the program CORRECT (refer to the 
Special Function PORIG). Execution of the seeond control 
instruction causes the two command corrections to be 
made, starting at the right half of the word at 2108 rela- 
tive to the program origin. The first command operand 
address is relative to the program origin; the second to 
COMMON. 

The results of the CMD instructions (expressed in TAC 
format) will be: 

Location New Contents 

Program Origin + 210g JNOL, Program Origin + 14g 

(right half) 
Program Origin + 2118 TMQ, CSA of COMMON + 30 8 
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ALPHA - Replaces Word(s) in Alphanumeric Format 



FUNCTION 



Replaces the contents of one or more consecutive memory- 
locations with words in alphanumeric format. 



FORMAT 



PARAMETERS 



L 


Location 


Command 


Address and Remarks 


n 


loc 


ALPHA 


replacement 



n (OPTIONAL) - The number (1-7) of words to be replaced. 
If omitted, 1 is assumed. 



replacement - Sets of eight alphanumeric characters. 
Spaces are significant. All Philco characters are 
permitted. 



ACTION 



REMARKS 



n - Consecutive words starting at loc are replaced by 
replacement . ~~ 

Refer to OCT, REMARKS, concerning relocatable cor- 
rections. 



EXAMPLE 



Alpha replacements must start at the beginning of the 
Address and Remarks field. 



L Location 

3 205P 

2 11200 



Command Address and Remarks 

ALPHA ONEAANDATWOAARE 

THREE.AA $ 
ALPHA ABSOLUTEEXAMPLEA$ 



Explanation: Execution of these instructions causes the 
contents of the memory locations listed below to be re- 
placed with the following information (expressed in TAG 
format): 



Location 

Program Origin + 205g 
Program Origin + 2068 
Program Origin + 207g 

11200g 
llZOlg 



New Contents 

W/ONEAANDA$ 
W/TWOAAREA$ 
W/THREE.AA$ 

W /ABSOLUTE! 
W/EXAMPLEA$ 



It 1 *L 

1 1-1 J 



SECTION XII 
SPECIAL FUNCTIONS 



This category of 32KSYS control 
instructions includes those which 
perform miscellaneous computer 
operations. Among these operations 
are filling memory, relaying mes- 
sages to the operator via the Console 
Typewriter, and halting the com- 
puter. 
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CLEAR 



CLEAR - Clears Memory 



FUNCTION 



Clears all memory from location lOOOOg to the end of 

.._ a- ri i ;_*. _„_~^ I AH r,afi-i Kite r>oT wni*rfl. 

memury iu iiacu (juiiil jiciw:> \ -x^- '-i*- — ■»- j •• •- 



FORMAT 



Location 



Command 



o 



LEAR 



Address and Remarks 



ACTION 



All memory locations between lOOOOg and the effective 
end of memory inclusive are cleared to fixed point 
zeros . 
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CLOCK - Types Accounting Clock Date and Time on 
Console Typewriter 



FUNCTION 



Causes the date and time from the Accounting Clock to 
be typed on the Console Typewriter, 



FORMAT 



L 


Location 


Command 


Address and Remarks 






CLOCK 





ACTION 



The date and time as indicated by the Accounting Clock 
are typed on the Console Typewriter (refer to Normal 
Type-Out , below) in the form AMM-DD AHH-MM-TM 
and stored in the Address and Remarks field of the CLOCK 
control card before the card is written on TSYSOUT. 



REMARKS 



CONSOLE 
TYPEWRITER 
NORMAL 
TYPE-OUT 



CONSOLE 
TYPEWRITER 
ERROR 
TYPE-OUT 



1. If the CLOCK instruction is given and a computer has 
no Accounting Clock, the instruction will be ignored. 

2. If the Accounting Clock is unavailable when a CLOCK 
command is given, the Error Type-Out, below, will 
occur and the next control instruction will be executed. 

Type Out Explanation 

date, time The CLOCK instruction was encountered 

and the date and time are typed via the 
Account Clock in the form: AAK /fM- 
DDAHH-MM. TA where MM- DD is the 
month and day, and HH-MM.T is the 
hour (per 24-hour day), the minute, 
and tenth of a minute. 

CLOCK The Accounting Clock was interrogated 

FAILURE but was unavailable. 
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COMMON - Sets Common Storage Area 



FUNCTION 



Sets the length and core starting address of the common 
storage area to be used by relocatable binary programs. 



FORMAT 



L 


Location 


Command 


Address and Remarks 






COMMON 


length, m 



PARAMETERS 



length - The number (decimal) of locations to be set 
aside for Common storage. 



m - The starting address of the Common storage area. 
If a value less than 10000_ is specified, exit will 



be made to 1XCONER. 



ACTION 
EXAMPLE 



m and length are stored for use by the loader. 

Assume that a relocatable binary program is to be loaded 



L Location Command Address and Remarks 



COMMON 596, 12000 



Explanation: Execution of this instruction causes the 
COMMON storage area to be preset to 596 locations, 

beginning at location lZOOOg . 
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ENDMEM - Sets the Effective End of Memory 



FUNCTION 



Sets the effective end of memory for System functions. 



FORMAT 



PARAMETER 

ACTION 
REMARKS 



L 


Location 


Command 


. 

Address and Remarks 






ENDMEM 


m 



m - The new effective end of memory. 

The effective end of memory is set to m. 

The effective end of memory is reset to 77777 fl when 
a JOB control instruction is executed. 
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FILL - Fills Memory 



FUNCTION 



Fills memory locations with the indicated filler. 



FORMAT 



L 


Location 


Command 


Address and Remarks 






FILL 


addr, , addr-, , filler 



PARAMETERS 



addr \ (OPTIONAL) - The starting address of the area 
in memory to be filled. If omitted, addr , is auto- 
matically set to 10000 8- 



addr ? (OPTIONAL) - The ending address of the area in 
memory to be filled. If omitted addr ? will auto- 
matically be set to the effective end of memory. 

filler (OPTIONAL) - to 16 octal characters. 

1. If no characters, memory specified will be filled 



i. If two characters, memory specified will be filled 
with a word containing the 2 characters duplicated 
8 times. 

3. If more than two characters, memory specified 
will be filled with the characters converted and 
right justified. 



REMARKS 



If all parameters are omitted, memory from location 
10000g to the effective end of memory will be filled 
with zeros. 



ACTION 



All memory locations between addr . and addr 7 in- 
clusive are filled with filler. 
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HLT - Halts Computer Operation 



FUNCTION 



Relays messages to the operator via the Console Type- 
writer and stops the computer to permit a manual oper- 
ation. 



FORMAT 



L 


Location 


Command 


Address & Remarks 






HLT 


message 



PARAMETER 



ACTION 



message - Fifty- six or fewer alphanumeric characters 

(including spaces) written in the Address and Remarks 
field, that compose a message to the operator. 

message is typed on the Console Typewriter. Upon com- 
pletion of the type -out, the computer halts, enabling the 
operator to perform the manual action specified by mes- 
sage. Pressing advance causes 32KSYS to read and exe- 
cute the next control instruction. 



REMARKS 



When the computer stops, all ones are displayed in the 
A, Q, and D Registers, indicating to the operator that 
this is a system halt. 



IBIT 



TOTT - f!hanor«»Q Trwiiratnr Rita 



FUNCTION 



Changes the bit configuration in the indicator word 
(1IBIT), which serves as a pseudo Toggle. 



FORMAT 



L 


Location 


Command 


Address and Remarks 






IBIT 


n, n, ---n 



PARAMETER 



n - One or more decimal numbers, through 47 which 
designate the specific bit(s) to be changed (i.e., to 
change a zero to a one, or a one to a zero). 



ACTION 



• Each number placed in the Address and Remarks 
field as a parameter reverses its particular bit in 
1IBIT. 



• 1IBIT is cleared when a JOB instruction is executed. 

• Bits in 1IBIT may be senaed by the ALTAC IF 
SENSE BIT statement. 
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JMP - Transfers Control 



FUNCTION 



Transfers control to a specified address. 



L 


Loc ation 


Command 


Addres and Remarks 






jmp 


addr 



PARAMETERS 



jmp - A JMP command which indicates the portion of 
the word to which control is to be transferred. 
One of the following must be selected: 

JMP Indicates the left half of the word 

JMPL Indicates the left half of the word 



REMARKS 



JMPR Indicates the right half of the word 

addr - The address to which control is to be transferred. 

If an asterisk {*) is specified, the jump address will be 
the starting address of the last program loaded. 

JMP, JMPL and JMPR will have the same action if an 
asterisk is used as the parameter, 



J ? = Q 



NOPRINT 



NOPRINT - Inhibits Printing of Control Instructions 



* UNCTION 



Sets 3ZKSYS to inhibit the printing of executed control 
instructions „ 



FORMAT 



PARAMETERS 
ACTION 



L 


Location 


Command 


Address and Remarks 






NOPRINT 





None 

32KSYS is ser to .nhibit the print .ng of executed control 
instructions unci a PRINT or a JOB -.nstruction \s en- 
countered. 
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PRINT - Permits Printing of Control Instructions 



FUNCTION 



Seta 32KSYS to print executed control instructions. 



FORMAT 



L 


Location 


Command 


Address and Remarks 






PRINT 





PARAMETER 



None 



ACTION 



32KSYS is set to print executed control instructions 
until a NOPRINT instruction is encountered. 
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PORIG - Sets the P-Relative Address in the COMMAND 
(CMD), OCT, ana ALfHA uorrecuon noutiueo 



FUNCTION 



FORMAT 



PARAMETER 



ACTION 



Sets the P- relative address in the COMMAND (CMD), 
OCT, and ALPHA corrective routines to the absolute 
value of the addr or to the origin of the id. 



L 


Location 


Command 


Address and Remarks 






PORIG 


addr or id 



addr - The address to be used for P-relative corrections. 

id - The identification of a program whose origin address 
~~ will be used for P-relative corrections. 

The address represented by the parameter in the com- 
mand is placed in the P-relative address used by the 
COMMAND (CMD), OCT, and ALPHA correction 
routines. 
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PROGTAPE - Assigns a Program Tape 



FUNCTION 



Assigns a designated tape as the user's program tape. 



FORMAT 



L 


Location 


Command 


Address and Remarks 






PROGTAPE 


t 



PARAMETER 



ACTION 



REMARKS 



t - The symbolic tape onto which subsequent compiled 
programs will be written. 

All subsequent programs compiled within the current 
job will then be written on t following compilation. 

1. Any tape designated as the program tape must 
contain a block of Z's, which indicates the location 
for the storage of the next program. 

2. A PROGTAPE assignment is valid until another 
PROGTAPE or JOB control card. 

3. t may not be a system tape. 

q t W/ufc M»iL 4^ i J^~ JUrJL - 
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REM 



REM - Relays Remarks to an Operator 



FUNCTION 



xvei3.ys messages to the operator via the console 
Typewriter without stopping computer action. 



FORMAT 



L 


Location 


Command 


Address and Remarks 






REM 


message 



PARAMETER 



message - Fifty-six or fewer alphanumeric characters 
™ (including spaces) written in the Address and 

Remarks field, that compose a message to the oper- 
ator. The characters should be acceptable to the 
Console Typewriter. (Refer to 1TYPOUT, SYS 
Entries). 



ACTION 



message is typed on the Console Typewriter without 
stopping computer action. 
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SYSOPS - Compiler Option Word 



FUNCTION 



Changes bits in the compiler option word (1SYSOPS) 
to offer the programmer additional compiler optiona. 



FORMAT 



PARAMETER 



ACTION 



REMARKS 



L 


Location 


Command 




Address and Remarks 






SYSOPS 


n, n, n, , . , n 





n - One or more decimal numbers, through 10, which 
designate the specified bit to be changed. 

When a SYSOPS control instruction is executed, the 
designated bits are reversed in 1SYSOPS for use by 
32KSYS or compilers. 

1. 1SYSOPS is cleared whenever a new JOB instruc- 
tion is executed. 



?.. Exit will be made to 1XCONER if any number 
greater than 10 is specified in the Address and 
Remarks field or the SYSOPS control instruction. 

The table on the following page describes the bit 
location within 1SYSOPS that may be changed at the 
programmer's discretion: 
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Bit Explanation 

If set, Phiico 212 mnemon ; c commands will be compiled into their 
proper bit configuration, otherwise such commands will be considered 
command faults. 

1 If set, POSSIBLE F-BIT ERROR will appear on the code edit whenever 
a possible F-Bit error is detected during a TAC compilation, 

2 If set, TAC will not store the intermediate code in the higher portion 
of memory. Instead, the code will be written onto TSYSCR3, and the 
memory space released will be used for the symbol table. 

3 If set, the compiler assumes that its input will be in binary-image 
mode on a tape other than TSYSIN. 

4 If set, the compiler assumes that its input will be in hollerith-image 
mode on a tape other than TSYSIN, 

5 If set, the COBOL compiler interprets columns 1-72 only and also 
considers the 8-4 punch as the quote character rather than the semi- 
colon. 

6 If set, the COBOL compiler operates in "test mode" to aid in com- 
piler debugging, Intermediate compiler files are edited and added to 
the normal compiler printer output. 

7 If set, the internal loader (1INTLD) will search the tape with the 
symbolic tape name XSYSTEM. (This bit; is tested only when the 
internal loader is instructed to by the object program). 

8 If set, the addj| and/or addr , parameters of DUMP controx instruc- 
tions less than lOOOOg will be valid, and will permit the programmer 
to obtain dumps of the memory area reserved for 32KSYS, 

9 If set, the FORTRAN IV compiler operates in "tes* mode" to aid in 
compiler debugging; i.e. , iBITS 0-18 will be interrogated by the 
FORTRAN IV compiler. 



10 



If set, all 32KSYS preset symbols are inhibited, enabling 8KSYS 
programs not requiring 8K tape libraries at compile time to be 
compiled with 32KSYS TAC. 
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SYMDEF - Defines a Symbolic Address 



FUNCTION 



Adds the defined symbolic address to the SYMBOUT 
list, and defines REFOUT's having symbolic addresses 
identical to it. 



FORMAT 



PARAMETERS 



ACTION 



REMARKS 



L 


Location 


Command 


Address and Remarks 






SYMDEF 


symbol , m n 

n 



symbol - The symbol (NAME.FLAD) being defined. 

m - The address which defines symbol . 

An attempt is made to find symbol in the REFOUT list. 
If found, m is used to satisfy loading conditions. 
Whether found or not, symbol and m are then added to 
the SYMBOUT list for subsequent reference. 

If symbol is greater than 16 characters, or NAME. 
FLAD is not separated by a period, or m is not an 
octal address, or each symbol is not defined by an 
address parameter, exit is made to 1XCONER. 

Each symbol must be separated from m with a comma 
(, ) and each symbol , m must be separated from the 
following symbol, m with a semi-colon (;). 



SECTION XIII 
32KSYS ENTRIES 



32KSYS Entries permit the programmer to 
make use of specialized routines used by 
32KSYS. The entries are locations within 
32KSYS which contain a transfer of control 
to a specific routine. Some routines, at 
the conclusion of their operation, return 
control to the calling program, while others 
transfer control to another 32KSYS entry. 

The programmer may use these routines by 
writing a transfer of control to the desired 
32KSYS entry. This transfer must be made 
to a symbolic address as designated herein. 
This symbolic address will be defined auto- 
matically by TAC when the program is com- 
piled. 
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Instruction to an Octal Address 



FUNCTION 



Converts the first parameter in the Address and 
Remarks field of a control instruction to an octal ad- 
dress. 



SYMBOLIC 
ADDRESS 



SYS.1ADCONI 



PREDOMINANT 

USER 



32KSYS and/or the programmer 



PRESET 
REQUIREMENTS 



The parameter must be an asterisk (*) [ 1NTRY JA will 
be substituted! or an address. 



ACTION 



EXIT 



• The first parameter in the Address and Remarks 
field of a control instruction is converted and 
stored in the A Register. Spaces are suppressed. 

• Termination of the first parameter is determined 
by the appearance of a comma, dollar sign, slash, 
semi-colon, "equal" sign, "greater than" sign, 
right or left parentheses or number sign. The 
termination character is stored in 1BRKSTR right 
justified with leading zeros. 

• If an error is detected, exit is made to 1XCONER, 

Control is returned to the next sequential instruction in 
the calling program. 
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1ADC0NC 

1ADCONC - Converts the Next Parameter of a Control 
Instruction to an Octal Address 



FUNCTION 



Converts the next parameter in the Address and Remarks 
field of a control instruction to an octal address. 



SYMBOLIC 
ADDRESS 



SYS. 1ADCONC 



PREDOMINANT 
USER 



32KSYS and/or the programmer 



PRESET 
REQUIREMENTS 



SAME AS 1ADCONI (refer to 1ADCONI) 



ACTION 



SAME AS 1ADCONI (refer to 1ADCONI) 



EXIT 



Control is returned to the next sequential instruction in 
the calling program. 
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1CLOCK - Obtains and Edits the Clock Word 



FUNCTION 



Obtains and edits the clock word. 



SYMBOLIC 
ADDRESS 



SYS. 1 CLOCK 



PREDOMINANT 
USER 



32KSYS and/ or the programmer 



PRESET 
REQUIREMENTS 



None 



ACTION 



The clock word is edited in the following form: 

A Register = MMM-DDA 
Q Register = HH-MM.TA 



where 



MM = Month 
DD = Day 

J. * J- i X. X •_* IX A 
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Tenth of minute 



EXIT 



Control is transferred to the next sequential instruction 
in the calling program. 



1ENCODE 



1ENCODE - Image to Code Conversion 



FUNCTION 



SYMBOLIC 
ADDRESS 



Converts an Image Mode card of 2n consecutive core 
memory locations into the corresponding Code Mode 
card of n consecutive core memory locations. 

SYS.1ENCODE 



PREDOMINANT 
USER 



32KSYS and/or the programmer 



PRESET 
REQUIREMENTS 



The A -register should contain a word with bits 



= 





1-15 = 


IMAGE 


24 = 





25-39 = 


CODE 


40 = 





41-47 = 


n (if bits 41-47 are zero, n is set 




equal to 1). 



IMAGE is defined as the address of the first Image 
Mode word and CODE is defined as the address of the 
first Code Mode wcrd. 



ACTION 



The Image Mode card is converted into the correspond- 
ing Code Mode card with each illegal Image Mode 
character represented in Code Mode by a question mark. 
The Code Mode characters are defined in Philco 2000 
Code Combination Card, TF-17. 



EXIT 



REMARKS 



Control is returned to the next sequential instruction in 
the calling program. 

If the Image and Code areas overlap, then CODE (the 
address of the first code) must not fall between IMAGE 
+ 2 through IMAGE + 2n -1 inclusive. 
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1 END JOB 



1 END JOB - End of Job Routine 



FUNCTION 

SYMBOLIC 
ADDRESS 

PREDOMINANT 
USER 

ACTION 



Terminates a iob. 



SYS. 1ENDJOB 



32KSYS and/or the programmer 



• Snaps are edited if any were written. 

• A search for the next JOB control instruction is 
initiated. 

When a JOB control instruction is found: 

1. All tapes except those assigned to system 
PUN's and those held for the next job are 
rewound with lockout 

2. All symbolic tape names except system symbolic 
tape names and those held for the next job are 
released 

3. An end of job message is written on TSYSOUT 

4. TSYSDMP is rewound 

5. The JOB control instruction is executed. 
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1ERRDMP 



FUNCTION 

SYMBOLIC 
ADDRESS 

PREDOMINANT 
USER 

ACTION 



1ERRDMP - Error Dump Routine 

Initiate! 32KSYS poit-mortem dumping. 
SYS.1ERRDMP 

The programmer 



Whenever control is transferred to the 32KSYS post- 
mortem dump routine, either via 1ERRDMP, 1ZERO 
or 1SUBERR, the following action takes place: 

e The contents of all addressable registers are saved. 

• A type -out occurs on the Console Typewriter, 
signifying that a post-mortem dump is to be per- 
formed. A zero, 2, or 3 within the type-out 
indicates the memory location to which control 
was transferred. 

e If dumps are specified, snaps were written, or 
an error message is indicated, the dump edit 
routine is called. 

e TSYSDMP is used as an intermediate tape by the 
dump edit routine. 

• A search for the next JOB control instruction is 
initiated. 

When a JOB control instruction is found: 

1. All tapes except those assigned to system PUN's 
and those held for the next job are rewound with 
lockout 

2. All symbolic tape names except system symbolic 
tape names and those held for the next job are 
released 

3. An end of job message is written on TSYSOUT 

4. TSYSDMP is rewound 

5. The JOB control instruction is executed. 
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1ERRDMP 

CONSOLE Type -Out Explanation 

TYPEWRITER 

ERROR ERRDMP2 A programmed transfer of control 

TYPE-OUT to 1ERRDMP 
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1GETBL - Gets Blanks During Scanning 



FUNCTION 



Presets the 1SCANON subroutine to recognize (not 
suppress) spaces in the parameters contained in the 
Address and Remarks field of a control instruction. 



SYMBOLIC 
ADDRESS 



SYS.1GETBL 



PREDOMINANT 
USER 



32KSYS and/or the programmer 



PRESET 
REQUIREMENTS 



None 



ACTION 
EXIT 



1SCANON is set to recognize spaces. 

Control is returned to the next sequential instruction 
in the calling program. 



REMARKS 



1GETBL has no effect on the 1SCAN subroutine because 
1SCAN automatically resets itself to suppress spaces 
each time it is executed. 



EXAMPLE 



Refer to 1SCANON for examples using the five scan 
subroutines. 
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1IGBL - Ignore Blanks During Scanning 



FUNCTION 



SYMBOLIC 
ADDRESS 



Presets the 1SCANON subroutine to suppress spaces in 
the parameters contained in the Address and Remarks 
field of a control instruction. 

SYS. 1IGBL 



PREDOMINANT 
USER 



3ZKSYS and/or the programmer 



PRESET 
REQUIREMENTS 

ACTION 

EXIT 

REMARKS 
EXAMPLE 



None 



1SC.ANON is set to suppress spaces. 

Control is returned to the next sequential instruction in 
the calling program. 



1IGBL has no effect on the 1SCANBL subroutine because 
1SCANBL automatically resets itself to recognize spaces 
each time it is executed. 

Refer to 1SCANON for examples using the five scan 
subroutines . 
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1INTCMD - Executes a 32KSYS Control Instruction 



FUNCTION 



Execute* a 32KSYS control instruction. 



SYMBOLIC 
ADDRESS 



SYS.1INTCMD 



PREDOMINANT 
USER 

PRESET 
REQUIREMENTS 

ACTION 



The programmer 



Index register 7 contains the address of the first word 
to be loaded into 1CONLIN+1. 

• 1CONLIN+1 to 1CONLIN+9 is loaded. 

• The 32KSYS control instruction in 1CONLIN +1 to 
1CONLIN +9 is executed. 

• If an error occurs while executing the 32KSYS 
control instruction, exit is made to 1XCONER. 

e Index register 7 contains, on exit, the address 
of the last word transferred+1 . 



REMARKS 



The format of the control instruction may be in Con- 
sole Typewriter format (See Operating Procedures, 
Special Operator Actions) or standard 32KSYS card 
format. 



EXIT 



Control is returned to the next sequential instruction 
in the calling program. 
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11NTC0N 



1INTCON - Loads 1CONLIN + 1 to 1CONLEN + 9 



FUNCTION 



Loads 1CONLIN+1 to 1CONLIN+9 with specified 
memory. 



SYMBOLIC 
ADDRESS 



SYS, IIN'TCON 



PREDOMINANT 
USER 



ine programmer 



PRESET 
REQUIREMENTS 



Index register 7 contains the address of the first word 
to be loaded into iCONLIN+1. 



ACTION 



ICONLIN+i to 1CONLIN+9 is loaded from internal 
memory. 
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Index register 7 contains on exit the address of 
the last word trans ferred+1 . 



£vAl 1 



REMARKS 



Control is returned to the next sequential instruction 
in the calling program. 

See also 1XECUTI. 



1INTLD 



FUNCTION 

SYMBOLIC 
ADDRESS 

PREDOMINANT 
USER 

PRESET 
REQUIREMENTS 



1INTLD - Internal Loader 

Loads a program 
SYS.1INTLD 

32KSYS and/or the programmer 

The A and Q Registers contain: 

1. The identification id of the program to be loaded 

in the A Register. The id must be eight characters 
or fewer, ielt-justified and space -filled to the 
right if necessary. 

2. The following specified bit designations are to be 
placed in the Q Register: 

Bits 18-23 The program unit number (PUN) 
on the tape on which the program 
is stored. 

be checked for loading from an 
alternate system tape. 



Bit 44 



Bit 45 



Bit 46 



Bit 47 



If set to one, control is to be trans- 
ferred to the starting address of the 
program after it is loaded. 

If set to one, the direction of the 
search will be backward. 

If set to one, an ABS program is to 
be loaded. 

If set to one, an RPL program is to 
be loaded. 



CAUTION: If Bits 46 and 47 are zero, an exit will be 
made to 1XCONER. If more than one of these bits is 
given, bit 47 will be assumed to be the correct bit. 
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1INTLD 



ACTION 



If Bits 43 and 45 are zero, the tape specified by 
the Q Register will be searched forward for the 
Drocram SDecified bv id. If the nroeram is not 
found before encountering a block of Z's the tape 
will be searched backward, If the program still 
cannot be found before encountering "begin tape", 
exit will be made to 1XCONER, 



If bit 45 is one, the tape specified will be searched 
backward only. 



REMARKS 



EXAMPLE 



• If bit 43 is one and bit 7 of 1 SYS OPS is one, a tape 
with the symbolic name XSYSTEM, rather than the 
PUN in the Q Register, will be searched. 

• Control will be transferred to the loaded program 
if bit 44 of the Q Register is set to one, otherwise 
control is returned to the next sequential instruc- 
tion in the calling program, 

1. Internal loader calls may be inserted in a program 
during compilation by use of the internal load gen- 
erator, LOADGEN (Library routines). 

The following example illustrates the calling of a program 
into memory by another program during the latter's exe- 
cution. 



Location Command 



Address and Remarks 



TMA 
TMQ 
JMP 



W/SEG1 $ 

N/6 T23; 1/1 T47$ 
SYS. 1INTLD 



Explanation: Execution of these instructions causes 
the program SEG1 to be loaded into memory and control 
returned to the next sequential instruction in the calling 
program. 
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1MEMSIZ 



1MEMSIZ - Checks Memory Overflow 



FUNCTION 

SYMBOLIC 
ADDRESS 



Tests the given address for memory overflow. 
SYS. 1MEMSIZ 



PREDOMINANT 
USER 



32KSYS and/or the programmer 



PRESET 
REQUIREMENTS 

ACTION 



£-Al 1 



REMARKS 



The A Register contains the address to be tested at 
T39. 

• The specified address is tested against the effective 
end of memory. 

• If the address is legal, the Q Register is made 
zero. 

• If the address is illegal, the Q Register is made 
all ones. 

• The A Register contains the effective end of 
memory +1 at T39. 

Control is returned to the next sequential instruction 
in the object program. 

The effective end of memory, reset by the JOB control 
instruction to 77777 g , can be changed by the ENDMEM 
control instruction. 
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1NXTCRD 



page revised 4--15-65 



1NXTCRD - Obtains the Next Card 



FUNCTION 



UDtams trom isisiin tne next, udiu m v^uut, »«v U - .,- 

verting from Image, if necessary) and stores it in the 
ten memory locations beginning at 1CONLIN. 



SYMBOLIC 
ADDRESS 



SYS. 1NXTCRD 



PREDOMINANT 
USER 

PRESET 
REQUIREMENTS 



ACTION 



EXIT 



REMARKS 



32KSYS and/or the programmer 

If Bit 43 of 1CONBIT is set to one and the mode of input 
is image, only the command field will be converted to 
Code Mode and transferred to 1CONLIN+2. Other dat S in 1C0NLIK rei 

unchange< 

• The location of the first word of the next card, 
which was read into an input buffer area in 
memory as part of a block from the system 
input tape is stored in Index Register 1. 

• If input is in Code Mode, the ten words in the 
buffer area which compose the next card will be 
transferred directly to 1CONLIN. 

• If input is in Image Mode, it will automatically be 
converted to Code Mode during its transfer to 
1CONLIN (subject to Bit 43 of 1CONBIT), and the 
location of the image card in the buffer area will 
be placed into Index Register 1. Illegal Image 
Mode characters appear as question marks (?) in 
Code Mode. 

Control is returned to the next sequential instruction 
in the calling program. 

If a JOB card is encountered, an exit will be made to 
1XCONER. 
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1NXTCON - Next Control Instruction Routine 



FUNCTION 



Obtains and executes the next control instruction. 



SYMBOLIC 
ADDRESS 



SYS.1NXTCON 



PREDOMINANT 
USER 



32KSYS and/or the programmer 



ACTION 



Snaps are edited, if any were written. 

The next control instruction is obtained from 
the ten memory locations starting at 1CONLIN 
via the 1NXTCRD routine. 



EXIT 



• When the instruction is obtained, the command 
field is interpreted. 

• The NAME/SYMBOL list is cleared if any 
had been established. 

If the control instruction is legal, it will be executed. 
Illegal instructions cause a transfer to 1XCONER. 



U-lf 
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1PRTC0N - Writes 1CONLIN on TSYSOUT 



FUNCTION 



Writes 1CONLIN to 1CONL1N+9 on TSYSOUT 



SYMBOLIC 
ADDRESS 



SYS. 1PRTCON 



PREDOMINANT 
USER 

ACTION 



32KSYS and/or the programmer 



1CONLIN to 1CONLIN+9 is edited for printing (data 
select 0, line feed 1, and end of line character) and 
is written on TSYSOUT. 



EXIT 



Control is returned to the next sequential instruction 
in the calling program. 



13-18 



1PRTMSG 



1PRTMSG - Writes Message on TSYSOUT 



FUNCTION 

SYMBOLIC 
ADDRESS 

PREDOMINANT 
USER 

ACTION 



EXIT 



Write* message on TSYSOUT 
SYS. 1PRTMSG 

32KSYS and/ or the programmer 



The fifteen words beginning at 1MSGCON are edited 
for printing (data select 0, line feed 1, and end of line 
character) and are written on TSYSOUT. 

Control is returned to the next sequential instruction 
in the calling program. 
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1PRTRUN 



1PRTRUN - Empties Buffer for TSYSOUT 



FUNCTION 

SYMBOLIC 
ADDRESS 

PREDOMINANT 
USER 

ACTION 

EXIT 



Empties buffer for TSYSOUT 
SYS.1PRTRUN 

32KSYS and/or the programmer 

The output buffer for TSYSOUT is emptied. 

Control is returned to the next sequential instruction 
in the calling program. 
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1PUNSYM 



1PUNSYM - Finds Symbolic Tape Name 



FUNCTION 



Finds a symbolic tape name, referencing a given 
program unit number (PUN). 



SYMBOLIC 
ADDRESS 

PREDOMINANT 
USER 

PRESET 
REQUIREMENTS 

ACTION 



SYS. 1PUNSYM 



32KSYS and/or the programmer. 



The A Register contains a PUN at T23. 



If the PUN is illegal or undefined, exit is made to 
1XCONER. 



If the PUN is legal, the first symbol in 32KSYS's 
symbolic tape name list assigned the given PUN is 
left in the A Register left-justified with trailing 
blanks . 



EXIT 



Control is returned to the next sequential instruction 
in the calling program. 
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ISC AN - Scans the First Parameter of a Control 
Instruction Suppressing Spaces 



TTTTWrTTOM 



the first parameter contained in the Address and Remarks 
field of a control instruction. 



SYMBOLIC 
ADDRESS 



SYS. 1SCAN 



PREDOMINANT 
USER 



32KSYS and/or the programmer 



PRESET 
REQUIREMENTS 



None 



ACTION 



The first parameter in the Address and Remarks 
field of a control instruction is scanned and stored 
in 1WRD1 and 1WRD2. Spaces are always sup- 
pressed. 



Termination of the first parameter is determined 
by the appearance of a standard 32KSYS break 
character (a comma, semi-colon, slash, period, 
or dollar sign). 

All characters of the first parameter (a maximum 
of 16) are stored upon exit from the subroutine in 
iWRDl and 1WRD2, acting as a double-length 
register. The characters are stored right-justified 
with leading zeros. 

The number of characters recognized by the 
1SCANBL, 1SCAN, 1SCANON subroutines is 
stored in the left-address portion of 1CHARCT 
prior to the exit from the subroutine. 

Because the subroutine stores 16 or fewer charac- 
ters, the results are not guaranteed if more than 
16 are used. 



EXIT 



Upon completion of the subroutine, control is returned 
to the next sequential instruction in the calling program. 



li-Ll 



ISC AN 



REMARKS 1. 1SCAN always suppresses spaces within the first 

parameter. 

2. If additional parameters of the same control line 
are to be scanned, 1SCANON must be used. 

EXAMPLE Refer to 1SCANON for examples using the five scan 

subroutines. 
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1SCANBL 



tan AXTOT 0/»o««< +V»#« CMfst TViT-owofor nf a frmtrnl 

Instruction Recognizing Spaces 



FUNCTION 



Initializes the 32KSYS scanning subroutine and stores 
the first parameter contained in the Address and 
Remarks field of a control instruction. Spaces are 
recognized (not suppressed). 



SYMBOLIC 
ADDRESS 



SYS. 1SCANBL 



PREDOMINANT 
USER 



32KSYS and/or the programmer 



ACTION 



The first parameter in the Address and Remarks 
field of a control instruction is scanned and stored 
in 1WRD1 and 1WRD2. Spaces are relevant. 

Termination of the first parameter is determined 
by the appearance of a standard 32KSYS break 
character (a comma, semi-colon, slash, period 
or dollar sign). This break character appears in 
the A Register and SYS. 1BRKSTR at exit, right- 
justified with leading zeros. 

All characters of the first parameter (a maximum 
of 16) are stored in 1WRD1 and 1WRD2, acting as 
a double-length register. The characters are 
stored right-justified with leading zeros. 

The number of characters recognized by the 
1SCANBL, 1SCAN, and 1SCANON subroutines is 
stored in the left address portion of 1CHARCT just 
prior to the exit from the subroutine. 

Because the subroutine stores 16 or fewer charac- 
ters, the results are not guaranteed if more than 16 
are used. 



EXIT 



Upon completion of the subroutine, control is returned 
to the next sequential instruction in the calling program. 



REMARKS 



If additional parameters of the same control line are 
to be scanned, 1SCANON must be used. 



EXAMPLE 



Refer to 1SCANON for examples using the five scan 
subroutines. 
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1SCANON 

1SCANON - Scans Additional Parameters of a Control 
Instruction 



FUNCTION 



Continues the scanning process begun by 1SCANBL or 
1SCAN by storing the next parameter contained in the 
Address and Remarks field of a control instruction. 



SYMBOLIC 
ADDRESS 



SYS. 1SCANON 



PREDOMINANT 
USER 



32KSYS and/or the programmer 



ACTION 



The same action listed for 1SCAN and 1SCANBL, except 
that the parameter beginning at the first column follow- 
ing the last break character encountered is scanned and 
stored. The use of 1SCANBL or 1SCAN must precede 
the use of 1SCANON otherwise unpredictable results 
will occur. 



REMARKS 



1. Additional 1SCANON calls must be given for 
subsequent parameters to be scanned. 

2. 1SCANON is always initially set by 1SCANBL to 
recognize spaces or by 1SCAN to suppress spaces. 

3. The automatic setting of 1SCANON to suppress or 
recognize spaces continues through each subsequent 
use of 1SCANON until changed by a 1GETBL or 
1IGBL call. 



EXAMPLE 1 



Assume that the Address and Remarks field of a coniici 
line stored in 1CONLIN contains the following charac - 
ters: 



A3, GAB C A/ DAE F/WVWi $ 



Location 



Command 



Address and Remarks 



JMP 



SYS. 1SCAN 



Explanation: Execution of this instruction causes the 
first parameter (terminated by the comma) to be scanned 
and characters A5 within it to be placed in 
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1SCAN0N 



1WRD1 as W/00000000 

The break character (, ) is placed in the A Register and 
1BRKSTR as 

W/0000000, 

The number of characters (1) is placed in iCHARCT as 

C/HLT, 1 

L Location Com mand Addr ess and Remarks 

JMP SYS. ISC ANON 

Explanation: Execution of this instruction causes the 
second parameter (terminated by a slash) to be scanned 
and the characters within it (OABCA) to be placed in 

1WRD1 as W/00000000 
liirnni ur /nnnnnnnr 

The break character {/) is placed in the A Register and 
1BRKSTR as 

w/ooooooo/ 

The number of characters (3) is placed in ICHARCT as 

C/HLT, 3 

Note that leading zeros must be determined by the 
character count, 

L Location Command Address and Remarks 

JMP SYS.1GETBL 

JMP SYS . 1SCANON 



Explanation: Execution of these instructions causes 
the third parameter (terminated by a dollar sign) to be 



'3-26 



1SCANON 

scanned and the characters within it (DAEF iWVWl ) to 
be placed in 

1WRD1 as W/000000DA 
1WRD2 as W/EFAVwVT. 

The break character ($) is placed in the A Register and 
1BRKSTR as 

W/0000000$ 

The number of characters (10) is placed in 1CHARCT 
as 

C/HLT, 10 

EXAMPLE TWO Assume that the Address and Remarks field of a control 

line stored in 1CONLIN contains the following charac- 
ters: 

A5, OABCA/DAEFAAAAAG$ 

L Location Command Address and Remarks 



JMP SYS.1SCANBL 

Explanation: Execution of this instruction causes the 
first parameter (terminated by a comma) to be scanned 
and characters, A5, within it to be placed in 

1WRD1 as W/00000000 
1WRD2 as W/000000A5 

The break character (, ) is placed in the A Register and 
1BRKSTR as 

W/0000000, 

The number of characters (2) is placed in 1CHARCT 
as 

C/HLT, 2 



1SCANON 



L Location Command Address and Remark* 

JMP SYS.1SCANON 

Explanation: Execution of this ins traction causes the 
second parameter (terminated by a slash) to be scanned 
and the characters within it (OABCA) to be placed in 

1WRD1 as W/00000000 
1WRD2 as W/0000ABCA 

The break character (/) is placed in the A Register and 
1BRKSTR as 

W/0000000/ 

The number of characters (5) is placed in 1CHARCT as 

C/HLT.5 

L Location Command Address and Remarks 

JMP SYS. 1IGBL 

JMP SYS.1SCANON 



Explanation: Execution of these instructions causes the 
third parameter (terminated by a dollar sign) to be 
scanned and the characters within it (DAEFAAAAAG) 
to be placed in 

1WRD1 as W/00000000 
1WRDZ as W/0000DEFG 

The break character ($) is placed in the A Register and 
1BRKSTR as 

W/0000000$ 

The number of characters (4) is placed in 1CHARCT 
as 

C/HLT.4 
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1STRIPQ - Strips the Q Register of Spaces 



FUNCTION 

SYMBOLIC 
ADDRESS 

PREDOMINANT 
USER 

PRESET 
REQUIREMENTS 

ACTION 



EXIT 



Suppresses space characters in a word. 
SYS.1STRIPQ 

32KSYS and/or the programmer 

The word to be stripped is in the Q Register. 

All spaces are deleted from the word in the Q Register,. 

The stripped word is then transferred to the A Register, 
right-justified with leading zeros. 

Control is returned to the next sequential instruction 
in the calling program. 
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1SUBERR - Subroutine Error Exit 



b UINUT1UIN 



initiates JtAOIJ pUBl-UIuriCUl uumpmsr 



SYMBOLIC 
ADDRESS 

PREDOMINANT 
USER 

ACTION 



SYS.1SUBERR 



REMARKS 



Philco 2000 Subroutines and/or the programmer. 



The contents of the JA Register are saved. Control 
is transferred to the same 32KSYS post-mortem dump 
routine as that used by 1ERRDMP. Actions, except 
the type-out, listed for 1ERRDMP apply to 1SUBERR. 

If the programmer wishes, he may replace the auto- 
matic post-mortem dump entrance in 1SUBERR with 
an entrance to his own routine. 1SUBERR is reset 
to the standard 32KSYS function by the execution of a 
JOB control instruction. 



CONSOLE 

TYPEWRITER 

TYPE-OUT 



Type -Out Explanation 

ERRDMP3 A programmed transfer of control 

to 1SUBERR. 
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1TAPENO - Obtains a Program Unit Number (PUN) 



FUNCTION 



SYMBOLIC 
ADDRESS 



Obtains a program unit number (PUN) for the given 
parameter. 

SYS. 1TAPENO 



PREDOMINANT 
USER 



32KSYS and/or the programmer 



PRESET 
REQUIREMENTS 



The A Register contains the input parameter left 
justified with trailing blanks. 

The parameter is either: 

I. A symbolic tape name (a TAC symbol of 7 or 
fewer characters) or, 



ACTION 



2, A system PUN in Binary Coded Decimal. 

• The parameter is checked for legality. 

• If the parameter is illegal, exit will be made to 
1XCONER. 



REMARKS 



EXIT 



• If the parameter is a PUN, the A Register will 
contain the PUN (in binary) at T23 on exit. 

• If the parameter is a symbolic tape name, the 
symbolic tape name list will be searched. If the 
name is there, its associated PUN will be in the 
A Register at T23 on exit. If the name is not 
there, it is inserted in the list, a PUN is assigned, 
and that assigned PUN will be in the A Register at 
T23 on exit. 

At entrance, if the last character in the A Register is a 
slash (/), octal 61, instead of a blank, 32KSYS legalizes 
the assigned PUN for writing. 

Control is returned to the next sequential instruction in 
the calling program. 



1 ^-^1 



1TYP0UT 



1TYPOUT - Console Typewriter Type-Out 



TTIMrTTriM 



SYMBOLIC 

\ rM~\t> TTCQ 

-A 1~J i-J.LV 0— ' ^J^-/ 

PREDOMINANT 
USER 

PRESET 
REQUIREMENTS 



EXIT 



REMARKS 



Tvnfis alphanumeric characters from memory on the 

- J Z — "~ — *- — 

Console Typewriter. 
SYS. 1TYPOUT 



32KSYS and/or the programmer 

The A Register should contain: 

C/HLT, m;C/HLT,n 

where m is the address of the first of n words to be typed 
on the Console Typewriter, 

Control is returned to the next sequential instruction 
in the calling program. 

1, Trailing full words of spaces are not transmitted 
to the Console Typewriter, 

2„ The maximum number of characters per line of 
typeout is limited to the length of the Console 
Typewriter line (approximately 70 characters). 
Any number of lines may be typed using the 
carriage return character (octal 32) when appropri- 
ate. 
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1XCONER 



1XCONER - Control Line Error Routine 



FUNCTION 



SYMBOLIC 
ADDRESS 



Causes an error message to be written on TSYSOUT and 
32KSYS post-mortem dumping to be initiated. 

SYS.1XCONER 



USER 



32KSYS only 



PRESET 
REQUIREMENTS 



None 



ACTION 



Whenever control is transferred to 1XCONER, the 
following action takes place: 



An error indication is typed on the console type- 
writer (See ERROR MESSAGES). 

The contents of the JA Register are stored in the 
left address portion of 1NTRYJA. 



An error message is written on TSYSOUT, 
ERROR MESSAGES.) 



(See 



EXIT FROM 
ROUTINE 

REMARKS 



ERROR 
MESSAGES 



Following the type-out, control is transferred to the 
32KSYS post-mortem dump routine (refer to 1ERRDMP). 

Those 32KSYS error messages that are flagged by an 
asterisk in the following table inhibit the 32KSYS post- 
mortem dumping routine from producing dumps, even 
though requested by DUMP control instructions. 



Type-Out 

SYSE1 
*SYSE2 
SYSE3 
SYSE4 
SYSE5 
SYSE6 
SYSE7 
SYSE8 
SYSE9 
SYSE10 
SYSE11 



Printout 

PROGRAM NOT ON SPECIFIED TAPE 

CHECKSUM ERROR 

PROGRAM ORIGIN IN LIST AREA 

PROGRAM ORIGIN IN COMMON AREA 

UNDEFINED REFOUT(S) 

ILLEGAL CARD 

SYMBOL LIST OVERFLOW 

ILLEGAL SECTION WORD 

ILLEGAL TAPE NAME 

TAPE NAME PREVIOUSLY DEFINED 

ILLEGAL ADDRESS PARAMETER 






lAUUJNfc-K 



ERROR 

MESSAGES 

(Continued) 



Type -Out 

SYSE12 
SYSE13 

SYSE14 

*SYSE15 

SYSE16 

*SYSE17 

*SYSE18 

SYSE19 

*SYSE20 

SYSE21 
SYSE22 

*SYSE23 
SYSE24 
SYSE25 
SYSE26 
SYSE27 
SYSE28 

-SYSE29 

SYSE30 
SYSE31 

♦SYSE32 
SYSE33 
SYSE34 
SYSE35 

SYSE36 

*SYSE37 

*SYSE38 

SYSE39 

SYSE40 
SYSE41 

SYSE42 
SYSE43 
SYSE44 
SYSE45 



Printout 

ILLEGAL PUN 
TOO MANY PARAMETERS 
PUN TABLE OVERFLOW 
JOB CARD INTERCEPTED 
UNACCOUNTABLE MACHINE OR 
SYSTEM ERROR 

ILLEGAL SYS CONTROL INSTRUC- 
TION 

ILLEGAL MNEMONX 
ILLEGAL DECIMAL NUMBER 
ILLEGAL POS.TVON FOR BINARY 
POINT 

PARAMETER^) MiSSING 
SYMBOL NOT IN SYMBOL LIST 
ILLEGAL FROM- TO PARAMETER 
PARAMETER TOO LONG 
COMMON S.ZE EXCEEDS MEMORY 
ILLEGAL BREAK CHARACTER 
ILLEGAL MAGTAPE 
NAME,FLAD TOO LONG 
ILLEGAL NUMBER OF WORDS TO 
BE REPLACED 
ILLEGAL PARAMETER 
TSYSTEM TSYSiN. TSYSL.B CANNOT 
BE WRITE-ENABLED 
ILLEGAL PROG TAPE 
ILLEGAL OCTAL NUMBER 
TOO MANY BLOCKS TO BE READ 
FORMAT FOR .NTERNAL LOADER 
NOT SPEC. F.ED 
READING TO SENTINEL WILL 
EXCEED MEMORY 
NO ADDRESS iN LOCATION FIELD 
ILLEGAL FORMAT 
NEW COMMON BLOCK LENGTH 
EXCEEDS OLD 

PROGRAM OR. G.N EQUALS ZERO 
ILLEGAL USE OF TSYSIN IF SYS 
IN MAGTAPE MODE 
ILLEGAL START-END PARAMETER 
THIRD PARAMETER NOT (MASTER) 
MASTER PROGRAM NOT DEFINED 
SEGMENT AREA EMPTY 
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1XCONER 



ERROR 

MESSAGES 

(Continued) 



Type -Out 

SYSE46 

SYSE47 

SYSE48 
SYSE49 
SYSE50 

SYSE51 
SYSE52 

SYSE53 

SYSE54 

SYSE55 
SYSE56 
SYSE57 

SYS E58 



Printout 

A SYMBOL DEFINED MORE THAN 
ONCE WAS REFERENCED 
A REFERENCE SYMBOL WAS RE- 
DEFINED 

ILLEGAL TO LOCATE ON TSYSIN 
RELATIVE CSA EXCEEDS PMAX 
LIB MUST BE USED IF SUBS OR 
NOSUBS SPECIFIED 
ILLEGAL LIBRARY TAPE 
MORE THAN 7 LIBRARY TAPES 
SPECIFIED 

PARAMETER(S) SPECIFIED MORE 
THAN ONCE 

REFERENCE TO UNDEFINED 
COMMON BLOCK 
TAPE NAME TABLE OVERFLOW 
PARAMETER nn ILLEGAL 
PARAMETER nn MISSING 

Illegal CSA 
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1XECUTI 



1XECUTI - Executes the Control Line in 1CONLIN + 1 
to 'CONLIN +9 



FUNCTION 



Executes the control line in 1CONLIN+1 to 1CONLIN+9, 



SYMBOLIC 
ADDRESS 



SYS. 1XECUTI 



PREDOMINANT 
: SER 



The programmer 



t'ivESET 
REQUIREMENTS 



None 



AC ijon 



The 32KSYS control instruction in 1CONLIN +1 to 
1CONLIN +9 is executed. 



V MARKS 



If an error occurs, exit is made to 1XCONER. 

Control is returned to the next sequential instruction 
in the calling program. 

See also 1INTCON. 



7 - '.h 



1ZER0 



1ZERO - Exponent Fault Exit 



FUNCTION 



Initiates 32KSYS post-mortem dumping for a floating 
point exponent fault. 



SYMBOLIC 
ADDRESS 



SYS. 1 ZERO 



PREDOMINANT 
USER 



The programmer 



ACTION 



Control is transferred to the 32KSYS post-mortem dump 
routine, the same as that used by 1ERRDMP. All actions 
listed for 1ERRDMP, except the type -out, apply to 
1ZERO. 



REMARKS 



1. An exponent fault occurs whenever a floating 

point operation generates an exponent which 
cannot be entirely contained in the exponent 
field. 



If the programmer wishes, he may replace the 
automatic post-mortem dump entrance in 1ZERO 
with an entrance to his own routine. 1ZERO will 
be reset to the standard 32KSYS function by exe- 
cution of a JOB control instruction. 



CONSOLE 
TYPEWRITER 

TYPE-OUT 



Type -Out 



ERRDMPO 



Explanation 

A programmed transfer of control 
to 1ZERO. 
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SECTION XIV 



3 2KSYS SERVICE ROUTINES 



32KSYS Service Routines aid the programmer in perform- 
ing routine functions of tape maintenance, debugging and 
program monitoring. They are located on TSYSTEM in 
RPL format and are called via their program identity as 
described below. Any or all of their particular functions 
are then performed depending upon the programmer's use 
of optional control instructions recognized by the routine 
itself. These control instructions, including the com- 
mand, parameters, and break characters, are written in 
the same manner as that described for 32KSYS control 
lines. 



CALLING 

SERVICE 

ROUTINES 



Service routines may be called via their corresponding 
32KSYS control lines (AIDE, TACSERV, RPLC, etc.). 
Execution of the instruction in the following example 
causes the service routine AIDE to be called into opera- 
tion: 



L Location Command Address and Remarks 



AIDE 
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AIDE 



FUNCTION 



SERVICE 
ROUTINE 
INITIATION 



iUUCi 0£*£\1 i.\*lit UWUliili- 



Copies and/or compares information contained on mag- 
netic tapes. 

The AIDE service routine may be called into operation by 
the following instruction: 



L 


Location 


Command 


Address and Remarks 






AIDE 





INPUT -OUTPUT 
SYSTEM 

CONTROL 
INSTRUCTIONS 



AIDE uses 32KSYS XORD for all tape operations. 



AIDE accepts control instructions, written in standard 
32KSYS control line format: 



Instruction 



COPY 



COMPF 



COMPB 



COPYCOMP 



SPACEF 
SPACEB 
LOCTACL 
LOCREL 



Function 

Copies information without change 
from one tape to another. 

Compares information on two tapes in 
a forward direction. 

Compares information on two tapes in 
a backward direction. 

Copies information without change 
from one tape to another and then 
compares the information copied by 
reading both tapes in a backward 
direction. 

Spaces forward over a tape. 

Spaces backward over a tape. 

Locates a TACL (code mode) program. 

Locates ah REL program. 
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AIDE 



Instruction 
LOCRPL 
LOCSENT 
WRTABS 
WRTSENT 
REWIND 
ENDALL 
LOCABS 
REWINDLO 



Function 

Locates an RPL program. 

Locates a sentinel block. 

Writes an ABS program. 

Writes a sentinel block. 

Rewinds one or more tapes. 

Terminates the AIDE service routine, 

Locates an ABS program. 

Rewinds with lockout one or mere 
tapes. 



The functions of REWIND, REWINDLO, LOCABS, 
LOCREL, LOCTACL, LOCRPL, LOCSENT, WRTABS, 
WRTRPL, and WRTSENT are as described in Tape 
Handling. 



COPY 



Format 



Parameters 



Copies information without change from one magnetic 
tape to another. 



L, 


Location 


Command 


Address and Remarks 






COPY 
COPY 


tl, t2, sent, c 



tj - The symbolic tape from which information is to be 
copied. 

t2 - The symbolic tape to which information is to be copied. 

n - The number (decimal) of blocks. 

sent - The sentinel word to be used in locating a sentinel 
block. 
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AIDE 



Action 



c (OPTIONAL) - The mode of output to be used in indicating 
the number of blocks copied if sent is specified. If the 
parameter is omitted, T is assumed. 

F Indicates the Console Typewriter. 

T Indicates TSYSOUT, edited for the High-Speed 
Printer with Data Select 0. 

B Both F and T. 

If n is specified, 

• n blocks of information are copied from tj to t2; 

• _ti and_t2 are positioned after the last block copied. 
If sent is specified, 

• information is copied from tl to t2 until a sentinel 
block of sent is encountered; 






"wen iwjtc uii i£ Ana 



VL is positioned between the sentinel blocks; 
ti is positioned after the sentinel block. 



Example 



Location Command Address and Remark s 

COPY 4, T-14, 512 

COPY 6.T-14, ZZZZZZZZ 



Explanation: Execution of the first instruction causes 
512 blocks of information from system program unit 
number 4 to be copied onto T-14. Execution of the 
second instruction causes the information from system 
program unit number 6 to be copied onto T-14 until a 
sentinel block of W/ZZZZZZZZ is detected. 



AIDE 



COMPF 



Compares information on one magnetic tape with informa- 
tion on a second magnetic tape by reading both tapes in a 
forward direction. 



Format 



Parameters 



L 


Location 


Command 


Address and Remarks 






COMPF 
COMPF 


^1, t2, sent, c 



_ti - The first symbolic tape to be compared. 

tZ - The symbolic tape to be compared with the first. 

n - See COPY 



Action 



sent - See COPY 

£ (OPTIONAL) - The mode of output to be used for indi- 
cating inequalities. If the parameter is omitted, T 
is assumed and only the result of the comparison 
(DIFFERENCES or NO DIFFERENCES) will be written. 
on TSYSOUT. 

F Indicates the Console Typewriter. 

T Indicates TSYSOUT, edited for the High-Speed 
Printer with Data Select 0. 

B Both F and T. 

• ^i is compared with_t2 as specified by n or sent. 

• If sent is specified, the sentinel blocks are also 
compared. 

• If sent is specified, the comparison is terminated 
when a sentinel block of sent is encountered on tj. 

• Inequalities are recorded on c. 

• The tapes are positioned after the last block com- 
pared. 
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AIDE 

Example 



revision A-i5 



L Location Command Address and Remarks 

COMPF 4, T-14, 512, T 

COMPF 6, T-14, ZZZZZZZZ.F 



Explanation: Execution of the first instruction causes 
512 blocks of information on system program unit number 
4 to be compared in a forward direction with 512 blocks of 
T-14. Execution of the second instruction causes the in- 
formation on system program unit number 6 to be com- 
pared with T-14 until a sentinel block of W/ZZZZZZZZ is 
detected on 6. 



COMPB 



Format 



Remarks 



Compares information on one magnetic tape with informa- 
tion on a second magnetic tape by reading both tapes in a 
backward direction. 



L 


Location 


Command 


" 

Address and Remarks 


_..— _j 


i 


COMPB 
COMPB 


U>_t2» n , c 
U. *2» sent, c 



The parameters, action, and example for COMPB are the 
same as those of the COMPF control instruction, except 
that the comparison is made in a backward direction. If 
a begin-tape error occurs before the comparison is com- 
plete, the result of the comparison up to that point is 
written out according to c. 



COPYCOMP 



Format 



Copies information from one magnetic tape to another, 
and then compares the information copied by reading both 
tapes in a backward direction. 



■ 
L 


Location 


Command 


Address and Remarks 






COPYCOMP 
COPYCOMP 


_tl._t2. n . £ 
ti, t2, sent, c 



14-6 



AIDE 



Parameters 



Action 



_tl - The symbolic tape from which information is to be 
copied. 

_t2 - The symbolic tape to which information is to be copied. 

n - See COPY. 

sent - See COPY. 

c - See COMPF. 

• _tj is copied toj2. (See Action of COPY. ) 

• J-1 is compared with t2 in a backward direction. (See 
Action of COMPB. ) ~ 

• The tapes are positioned as they were prior to the 
execution of the COPYCOMP function. 



Example 



Location 



Command 

COPY 

COPYCOMP 

COMPB 



Address and Rema rks 

4, T-14, 512 

6.T-14, ZZZZZZZZ, F 

4,T-14,512,F 



Explanation: Execution of the first instruction causes 
512 blocks to be copied from system program unit number 
4 onto T-14. Execution of the second instruction causes 
system program unit number 6 to be copied onto T-14 
until a sentinel block of W/ZZZZZZZZ is detected on 6. 
Then 6 will be compared in a backward direction with 
T-14 and the number of blocks that were copied is indi- 
cated on the Console Typewriter. Execution of the third 
instruction causes 512 blocks on 4 to be compared in a 
backward direction with the same number of blocks on 
T-14. In both comparison cases, any inequalities will 
be typed on the Console Typewriter. 
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AIDE 

SPACEF 

Format 



Parameters 



Action 



Spaces forward over a magnetic tape. 



L 


Location 


Command 


Address and Remarks 






SPACEF 


t, n 



_t - The symbolic tape to be spaced. 

n - See COPY. 

t is spaced n blocks forward. 



SPACEB 



Format 



Parameters 

Action 



Spaces backward over a magnetic tape. 



Location 



Command 



Address and Remarks 



SPACEB 



t,n 



Same as SPACEF. 



t is spaced n blocks backward. 



ENDALL 



Format 



Action 



ERRORS 



Terminates action of the AIDE service routine. 



L 


Location 


Command 


Address and Remarks 






ENDALL 





The AIDE routine is terminated and control is returned 
to 32KSYS via 1NXTCON. 



Type -Out 



Print-Out 



AIDE El ILLEGAL CONTROL CARD 

AIDE E2 PARAMETERS MISSING 

AIDE E3 BEGIN-TAPE ERROR --NO SENTINEL OR 

TOO MANY BLOCKS 
AIDE E4 MORE THAN 8 CHARACTERS IN SENTINEL 

PARAMETER 
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AIDE 

Error Exit Following detection and indication of an AIDE error, con- 

trol is transferred to SYS. 1ENDJOB. 

AIDE EXAMPLE L. Location Command Address and Remarks 

AIDE $(1) 

REWIND ALPHA, GAMMA, BETA $(2) 

COPY ALPHA, GAMMA, 150 $(3) 

COPYCOMP BETA, GAMMA, 335, F $ (4) 

COMPB ALPHA, GAMMA < 150, F $(5) 

REWIND ALPHA, BETA $(6) 

ENDALL $(7) 

Explanation: Execution of these instructions causes the 
following action to take place: 

1. AIDE is called into operation. 

2. ALPHA, BETA, and GAMMA are rewound. 

3. 150 blocks of information are copied from ALPHA to 
GAMMA. 

4. 335 blocks of information are copied from BETA onto 
GAMMA, and are then compared in a backward direc- 
tion. Any differences are typed on the Console Type- 
writer. 

5. 150 blocks of information on ALPHA and GAMMA 
(referred to in Step 3) are compared in a backward 
direction. Any differences are typed on the Console 
Typewriter. 

6. Tapes ALPHA and BETA are rewound without lockout. 

7. Control is returned to 32KSYS. 
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ANALYZER 



ANALYZER SERVICE ROUTINE 



FUNCTION 



SERVICE 
ROUTINE 
INITIATION 



Prepares a listing of all references made by a program 

or a portion 01 a prugrun: lu a. =>^ev. ixicru om: ^ ■■■ » ; 

Any portion or all of memory may be specified. 



The ANALYZER service routine may be called into opera- 
tion by the following instruction: 

L Location Command Address and Remarks 

ANALYZER 



PROGRAM TO 

BE ANALYZED 



The program to be analyzed may be in RPL or ABS format 
and may appear on any magnetic tape except TSYSCR3, 
TSYSOUT or TSYSCR6. It is not loaded into memory. An 
ABS program on tape must be preceded by a dummy PMAX 
card, unless the program to be analyzed immediately fol- 
lows onTSYSIN. 



INPUT -OUTPUT 
SYSTEM 

CONTROL 
INSTRUCTIONS 



Format 



Parameters 



ANALYZER uses 32KSYS XORD for all tape operations, 



ANALYZER accepts two control instructions: ANALYZE 
and ENDALL. The instructions are written in standard 
32KSYS control line format. 



L 


Location 


Command 


Address and Remarks 




— 1 

format 


ANALYZE 


t, id, addri, addr2, addr3, 
addr4 



format - Format of the program to be analyzed. 

RPL Indicates RPL format 

ABS Indicates ABS format 

_t - The symbolic tape except TSY3CR3, TSYSOUT and 
TSYSCR6 that contains the input program. 

id (OPTIONAL) - The identity of the program to be ana- 
lyzed. If omitted, t will be assumed to be positioned 
at the start of the program. 
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ANALYZER 



Action 



ANALYZER 

EXAMPLE t 



addr i - The beginning address of the coding to be analyzed. 
addr2 - The ending address of the coding to be analyzed. 
addr3 - The beginning address of the referenced area. 
addr 4 - The ending address of the referenced area. 

• t is searched for program id. 

• Each instruction of the program to be analyzed is then 
examined individually from tape to determine: 

1. If its location falls within the range addri -addr2- 

2. If the memory address which it references falls 
within the range addr 3- addr4 . 

3. If the instruction contains a reference to an index 
register or is an index register-modified instruction. 

• All instructions meeting conditions (1) and (2) or (1) 
and (3) are sequenced by referenced location. 

• All processed output is then written onto TSYSOUT 

for printing on the High-Speed Printer in Data Select 0„ 

• t is normally positioned following the final block of 
the analyzed program. 

• The next ANALYZER control instruction is requested. 
L Location Command Address and Remarks 



RPL 



ANALYZE ALPHA, ALTAC3, 10000, 
22000, 0, 77777$ 



OUTPUT 
FORMAT 



Explanation. Execution of this instruction causes a list- 
ing of RPL program ALTAC3, located on ALPHA to be 
prepared. The listing will include those references to 
memory locations through 77777s made by program lo- 
cations 100008 through 22000s. 

The output of the ANALYZER service routine is written 
onto TSYSOUT for off-line printing on the High-Speed 
Printer with Data Select 0. Each page of output con- 
sists of a one -line heading statement, a listing of the 
sorted analyzed output, and an ending statement. 
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ANALYZER 



Heading 
Statement 

Ending 
Statement 



The heading statement includes the date, time, page num- 
ber and specified parameters. 

The ending statement is normally: END OF ANALYZER. 

If there was too much input data for the ANALYZER rou- 
tine to process, the following ending statement will appear: 

PROGRAM EXCEEDED ANALYZER MEMORY CAPACITY 



REMARKS 



1. Processing of each ANALYZE instruction is completed 
before the next instruction is executed. 



2. Separate outputs are written for each ANALYZE con- 
trol instruction executed. 

3. Programs need not be analyzed in the order they ap- 
pear on tape since a complete search (forward and 
backward) is made for each program. 



ERRORS 



Type -Out Print -Out 

ANAL El ILLEGAL CONTROL CARD 

ANAL E2 TAPE SPECIFIED IS RESERVED BY SYSTEM 

ANAL E3 PARAMETER MISSING 

ANAL E4 SPECIFIED FORMAT NOT ABS OR RPL 

ANAL E5 ILLEGAL RPL SECTION WORD 

ANAL E6 ILLEGAL ABS CARD 

ANAL E7 CHECKSUM ERROR 

ANAL E8 END PARAMETER LESS THAN START 



Error Exit 



Following detection and indication of the ANALYZER errrr 
ANALYZER searches for the ENDALL card and then trans 
fers control to 1NXTCON. 
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DATA 



DATA SERVICE ROUTINE 



FUNCTION 



SERVICE 
ROUTINE 
INITIATION 



INPUT-OUTPUT 
SYSTEM 



Transfers data required by a user's program from 
TSYSIN onto a specified tape. At the option of the 
user, the routine may also convert Image Mode input 
to Code Mode output and/or alter card format. 

The DATA service routine may be called into operatk-n 
by the following instruction: 



L 


Location 


Command 


Address and Remarks 






DATA 





Data uses 32KSYS XORD for all tape operatic -s 



CONTROL 

INSTRUCTIONS 



DATA accepts two control instructions: TAPE ar.d 
ENDDATA. 



The instructions are written in standard J2KSYS ror-ioi 
line format. 



TAPE 



Format 



Parameters 



Specifies the data transfer to be performed by the DATA 
service routine, and must be immediately followed oy 
the data to be transferred. 



Location 



Command 



TAPE 



Address and Remarks 



t, mode . words , cards 



t_- The symbolic tape except TSYSOUI and TSYSTEM 
onto which the data is to be transferred, 



mode (OPTIONAL) - The mode of the output d 



CODE 

or 
HOLL 



ata. 



Indicates Code Mode, Input may t- 
either Code or image Mode. 



I MACE 

or 
BINARY 



Indicates Image Mode input must be 
image Mode. If mode is emoted. 
input data will be transferred to r .r_ 
Code Mode, 10 words per card 1<T 
cards per block. 



DATA 



words (OPTIONAL) - The number (dec'mal) of words 

7-.of ^rai-rl tn hp trsr q(p t rpri tn the OUtDUt tdDe. If 

mode -Is CODE or HOj^l words may be any number 
from one through 10. T mode .s .MAGE or BINARY, 
words may be any number irom eric througn 20. 

cards (OPTIONAL) - The number sdecimai; of cards 
per block tc be rrarsf-rred to "be output tape. 

The product of words times latcls must be equal to or 
less than 128 , - . 



REMARKS 



1. 

2. 



Cards is required if ■vords is spec -Tied, 



Blank columns on a card are transcribed onto _t_as 
zeros if the transfer .s in image Mode, or as spaces 
(60„) if the transfei s ,n Code Mode. 



If the number of cards supplied as input data is not 
sufficient to meet '.he cards -p?i biOck requirement 
for the final block, cards of aL zeros or spaces 
will be provided for transfer to «"he output tape until 
the finai block has Pee . h'.'eri w-th the specified 
number of cards p-.r b.ock 



The remaining words in each biuik. determined by 
128 minus words time i -ircis w..i contain filler 



characters ( i 2 



8 " 



If bor.h words and c ads are Dm.':ed. -input data will 



be transferred tc t as 10 icrds per card, 12 cards 
per block if mode \s CODE o~ HOLL, 20 words per 
card six cards per '" n: ]•■ 
B'MAR V 



rv-\ * rA (-■ 



's fM AGE cr 



6. The TAPE Lomroi .r.s :ui. lion must be '-.be first 
card following the cii for DAT A. 

7. t is not rewound bv me DATA routine either before 
or after it is used, 

8. Data is transcriDen onto l_ Et-i.- r.g at the beginning 
of the next block. 
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DATA 



ENDDATA 



Terminate! the DATA service routine by writing the 
final output buffer block of data onto_t, and causee con- 
trol to be returned to 32KSYS. 



Format 



L 


Location 


Command 


Address and Remark* 






ENDDATA 





ERRORS 



Type -Out 



Print -Out 



DATA El ILLEGAL CONTROL CARD 

DATA E2 TAPE SPECIFIED IS RESERVED BY 

SYSTEM 
DATA E3 ILLEGAL FORMAT PARAMETER 

DATA E4 INPUT IS NOT IMAGE AS SPECIFIED 

DATA E5 WORDS/CARD NOT SPECIFIED OR 

ILLEGAL 
DATA E6 CARDS/BLOCK NOT SPECIFIED OR 

ILLEGAL 
DATA E7 WORDS/CARD X CARDS/BLOCK 

ILLEGAL 
DATA E8 MORE THAN 8 CHARACTERS IN 

PARAMETER 
DATA E9 PARAMETER IS NOT NUMERIC 



Error Exit 



Following the detection and indication of a DATA error, 
control is transferred to 1ENDJOB. 



DATA EXAMPLE 



Location Command Address and Remarks 



DATA 



$] 



ALPHA, IMAGE, 16,8 $2 



TAPE 
(Data to be transcribed) 

ENDDATA 

DATA 

TAPE BETA, CODE, 4, 30 

(Data to be transcribed) 

ENDDATA 



$': 
$4 
$<- 

St 



Explanation: Execution of these instructions causes the 
following action to take place: 

1. DATA is called into operation. 
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DATA 



2. ALPHA is specified as the tape onto which the Image 
Mode data is to be transferred in Image Mode, 16 
words per card, 8 cards per block. 

• The data is processed and transferred as 
designated. 

3. ENDDATA terminates the service routine. 

4 . The DATA instruction causes return of control to 
the DATA service routine. 

5 t BETA is the specified tape onto which the data is 
to be transferred. This transfer is to be in Code 
Mode, four words per card, 30 cards per block. 

• The data is processed and transferred as 
designated. 

6, ENDDATA terminates the service routine. Control 
is returned to 32KSYS. 
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FLID 



FUNCTION 



SERVICE 
ROUTINE 
INITIATION 



FLID SERVICE ROUTINE 



Finds or Lists the IDentities of RPL, ABS, REL, and 
TAC language programs on tape. 

The FLID service routine may be called into operation 
by the following instruction: 



L 


Location 


Command 


Address and Remarks 






FLID 


■ 



INPUT 
REQUIREMENTS 



Programs not starting at the beginning of a block will 
not be detected by FLID, and will be identified on the 
listing as OTHER. OTHER indicates that a block con- 
tains information not identifiable as RPL, ABS, REL, 
or TACL. 



ABS programs must be preceded by a dummy PMAX 
card. 



INPUT-OUTPUT 
SYSTEM 



FLID uses 32KSYS XORD for all tape operations. 



CONTROL 
INSTRUCTIONS 



FLID accepts six control instructions, written in 
standard 3ZKSYS control line format: 



Instruction 



Function 



REWIND 

LOCSENT 

SENTINEL 



Rewinds one or more tapes. 

Locates a specified sentinel block. 

Designates an ending sentinel block 
for subsequent FIND or LIST control 
instructions . 



FIND 
LIST 

ENDALL 



Searches for a specified program. 

Provides a listing of the type, ID, and 
block count of programs on a tape. 

Terminates action of the FLID service 
routine and returns control to 32KSYS. 
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FLID 



SENTINEL 



Format 



Parameter 



Action 



Remarks 



FIND 



Format 



Parameters 



The functions of LOCSENT and REWIND are described 
in the TAPE HANDLING Section. 

Presets FLID so that subsequent FIND or LIST control 

instructions will be terminated whenever the sentinel 
block indicated by this instruction is encountered. 



L 


Location 


Command 


Address and Remarks 






SENTINEL 


sent 



sent - The sentinel word to be used in locating a sentinel 
block, 

FLID is preset so that the operation of all subsequent 
FIND or LIST instructions - prior to another SENTINEL 
instruction - will be terminated whenever the sentinel 
block designated by sent is encountered. 

If the SENTINEL control instruction is omitted, a 



» ^4 £ r\ -*■ i- a, ■*• m ination r\4 



FIND and LIST operations. 
Searches a tape for a program. 



L 


Location 


Command 


Address and Remarks 






FIND 


t, format, id 



t - The symbolic tape to be searched. 
format - The type of program to be located. 

RPL Indicates an RPL program. 

ABS Indicates an ABS program. 

REL Indicates a REL program. 

TACL Indicates a TAC language program, 
id - The ID of the program to be located. 



FLID 



Action 



• _t_is searched forward for program id. 

• When id is encountered, _t_ is positioned at the 
beginning of the program. 

• If a sentinel block of Z's or the configuration 
specified by the SENTINEL control instruction is 
encountered, t_ is searched backwards. If the 
program is still not found, exit will be made to 
1XCONER. 



Example 



Location Command Address and Remarks 



FIND 



ALPHA, RPL, 

PROGRAMMA $ 



Explanation: Execution of this instruction causes 
ALPHA to be searched for the PPL program PRO- 
GRAMMA. After the program is located, ALPHA is 
positioned at the beginning of PROGRAMMA. If a 
designated sentinel or Z block is encountered, the tape 
will be searched backward. If the program is still not 
found, exit will be made to 1XCONER. 



T.TST 












in 



Searches a 

and block count of programs on the tape. The listing 
may be typed on the Console Typewriter and/or printed 
off-line on the High-Speed Printer. 



Format 



Parameters 



L 


Location 


Command 


Address and Remarks 






LIST 


t, format, mode 



_t_ - The symbolic tape to be searched. 

format - The type of programs to be listed. 
RPL Indicates RPL programs, 
ABS Indicates A3S programs. 
REL Indicates REL programs. 
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FLID 



TACL Indicates TAC language programs. 

ALL Indicates all of the above types of programs. 

mode - The tyne of output for the listing, 

T Indicates TSYSOUT for off-line printing 

on a High-Speed Printer. 

B Indicates TSYSOUT for printing on the High- 

Speed Printer and the Console Typewriter. 

F Indicates the Console Typewriter. 

If the mode parameter is omitted, T is assumed. 

Action . t_ is searched for the type of program(s) indicated 

by format. 

As each of the programs designated by format is 
encountered, its program type, ID and block count 
ate typed on the Console Typewriter and/or are 
written on TSYSOUT, for off-line printing. 

The listing action is terminated whenever the 
designated sentinel or a block of Z's is encountered. 

Remarks 1. In addition to indicating the type, ID and block count 

of each of the programs designated by format, FLID 
lists all sentinels and a count of all blocks from the 
initial position on the tape, up to and including the 
final sentinel block. 

2. If ALL is specified as format, blocks of information 
not recognized as RPL, ABS, REL, or TACL pro- 
grams will be listed as + + + + OTHER. 

3. Data which appears in the same format as a sentinel 
block, i. e. , contains 120 similar words, is listed 
as a sentinel but will not stop the listing function. 



An RPL program which contains any unrecognizable 
RPL control word will be listed by FLID, but will 
be identified as a BAD RPL. The block containing 
the unrecognizable control word and any blocks 
remaining in the program will be identified as 
+ + + + OTHER. 
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FLID 



5. If any sentinel block is encountered prior to an 
END card in a TACL program, or prior to a 
binary END or JMP card in an ABS or REL pro- 
gram, the listing will include: 

• The program type as TACL or BINARY (the 
latter denoting an ABS or REL program), 

• The first eight characters of the program iD, 

• The words NO END (to denote omission of 
the TAC END card or the binary jump card), 
and 

• The block count of the program. 



Example 



L Location Command Address and Remarks 



LIST 



ALPHA, TACL, B 



Explanation: Execution of this instruction causes TACL 
programs and sentinel blocks on ALPHA to be listed 
until the designated sentinel or Z block is encountered. 
The listing plus a total block count of the tape is typed 
on the Console Typewriter and written on TSYSOUT 



ENDALL 



Terminates action and returns control to 32KSYS, 



Format 



L 


Location 


Command 


Address and Remarks 






ENDALL 





Action 
ERRORS 



FLID is terminated and control is returned to 3ZKSYS, 



Type -Out 

FLID El 
FLID E2 

FLID E3 



Print -Out 

ILLEGAL CONTROL CARD 

ILLEGAL OR NO FORMAT 

SPECIFICATION 

MORE THAN 8 CHARACTERS IN 

SENTINEL PARAMETER 
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Error Exit Following the detection and indication of a FLID error, 

FLID searches for the ENDALL card, and transfer* 
control to 1NXTCON. 



PLUM 



PLUM SERVICE ROUTINE 



FUNCTION 



Creates a new library or updates an old one. 



SERVICE 
ROUTINE 
INITIATION 



The PLUM service routine may be called into oper- 
ation by the following instruction: 



L 


Location 


Command 


Address and Remarks 






PLUM 





INPUT-OUTPUT 
SYSTEM 



PLUM uses 32KSYS XORD for all reads, writes, and 
other tape movements. 



CONTROL 

INSTRUCTIONS 



PLUM accepts the following control instructions written 
in standard 32KSYS control line format: 



Instruction 



Function 



OLD LIB 



Specifies the tape and the identity of 
the library to be updated. 



NEW LIB 



Specifies the tape and the identity of 



nic 11& w iiL/i a. x y , 



GENTAPE 



Specifies the tape containing the 
generator to be added or replaced, 



ADDGEN 



Specifies the identity of the generator 
to be added or replaced. 



ABSOLUTE 



Indicates that absolute binary cards 
are to follow. 



ENDGEN 



Terminates the processing of a 
generator. 



ADDMACRO 



ENDMACRO 



Specifies the name of the macro 
skeleton to be added or replaced. 

Terminates the processing of a macro 
skeleton. 



PLUM 



Instruction 



Fur. + .or. 



ADDSUB 



ENDSUB 



ADDBRS 



Spe c f.es the name of the TAC language 
subroutine -c b- added or replaced. 

Terminates the processing of a TAC 
language subroutine 

Spec i>s the '.am" -:i a binary re- 
ocatab," subrout re 'o be added or 
replaced 



ME 



NEST 



DELETE 



ENDALL 



Denotes that the subroutine (TAC 
language or binary relocatable) can 
also be er'ered at the symbolic 
location spec .fed in the address field. 

Sign ftes ihat: *he subroutine (TAC 
ianguage or binary relocatable) to be 
added calls upon the subroutine 

sppc f .ed .r *he address field 

De'e'es a ma. ro generator, 01 sub- 
rout re from the , ibrary, 

Termjdt. : s he PLUM routne and 
retarrs ccrtro. to the SYSTEM /ia SYS. 

1 NAT CON 



REWIND 



Rev, rds one or more magr°r'.c tapes, 



POSITIONING 
ITEMS IN THE 
LIBRARY 



The function of REW.ND s as desv r bed :r the tape 
handling section 

When updating, routir.es must be prepared for addition 
deletion or replacement u. the nput deck according to 
the order of the corresponding rout-ries on the "old" 
library rape. The rela T <<e positicr^ng of items to be 
added to the library is provided for by the "before" 
option and by the programmers ordering of items in 
his input deck. 

New generators and subroutines are added to the end 
of the new library tape in th*= order lr which they appear 
unless the "before" opt on .s used Macros appear after 
the last macro of theit sp^c if.ed gererator unless the 
"before" option is exerc.sed. 



PLUM 



The "before" option is utilized by placing a semicolon 
after the name of the item to be added and following 
this semicolon with the name of the existing library- 
item that the new item is to precede. 



Initialization Instructions 



OLDLIB 



Format 



Parameters 



Action 



Remarks 



Specifies the tape and the identity of the library being 
updated. 



Location 



Command 



OLDLIB 



Address and Remarks 



t;oldid 



_t_- The symbolic tape of the library being updated, 

oldid - The identity of the library being updated. 

• If oldid and the identity of the library being updated 
are the same, PLUM requests the next control card 
which must be either REWIND or NEWLIB. 



v~w.*u*_r..w *_ x JL \J X 



• If the identities are not the same 

type-out occurs indicating this condition. To 
continue the PLUM run, the correct library may 
be mounted and ADVANCE depressed. 

1. If * is specified as t, TSYSLIB will be updated. 

2. The OLDLIB control instruction is omitted if a new 
library is being created (a library is not being 
updated). 

3. An OLDLIB control instruction may only be pre- 
ceded by a REWIND instruction and may only be 
followed by: 

REWIND 
NEWLIB 
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PLUM 

NEW LIB 
Format 



Parameters 



Action 



Remarks 



Specifies the tape and the dert >y of the new library. 



Location 



Command 



NLWLVii 



Address and Remarks 



ne w * a 



Jt_- The symbolic tape oi 'he :.orary be^g created. 

newld •■ Eight or ie ver aipha-.ume r .. characters that 
provide the .dert.ty of the library being created. 

• The identity of th- new library .s typed on the 
Console Typewr ,'er and appears :n the ed.ted 
listing on TSYSOUT- 

• PLUM :S set. *.o p'-oducf th- ■ brary on j_ 

1, Only one NEWLjB cortro* ,ns'ruit>on may be 
issued for each PlUM tun 

2, if a library is be r,g updated the OLDL1B mstruc 
*.; — ~,,,=4- T^T^mrio <Vi& MFW ! ,.R rs + rurtion. 

L1UU tliuoi ^* .1 v_ v. *~ *_* v. -iiw * - — ■ - 

3, Oniy the following convro. j s'r-.ct.cns are 
acceptable to PLUM a* th s - '.me 

GENTAPE 

ADDSUB 

ADDMACRO 

ADDBRS 

ADDGEN 

DELETE 

REWIND 

ENDALL 
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Updating Instructions 



GENTAPE 



Format 



Parameter 



Remarks 



Specifies the tape containing the generator to be added 
or replaced. 



L 


Location 


Command 


Address and Remarks 






GENTAPE 


_t_ 



t_- The symbolic tape containing the generator to be 
added to replaced. 

1. The ADDGEN control card must immediately follow 
the GENTAPE card or LIB E46 will result. 



2. If all generators to be added or replaced during 

the PLUM run are on one tape, then only one GEN- 
TAPE control instruction need occur. However, 
each change in the generator tape must be indicated 
by a GENTAPE control instruction. 



ADDGEN 



Format 



Parameters 



Contains the identity of the generator to be added to the 
library tape. 



L 


Location 


Command 


Addrpss and Remarks 






ADDGEN 


n;id 



n - The number (decimal) of RPL blocks of the generator 
or an asterisk (*). 



Action 



id - The identity of the generator to be added to replaced. 

• If_n_is a decimal number, PLUM searches the 
generator tape (in a forward direction only) for the 
id specified and then copies that generator onto the 
library according to the block count. 

• If n_ is an asterisk, the generator is added from 
absolute binary cards. The information from the 
cards is converted to RPL format and placed on 
the library tape. The id specified becomes the 
identity of the new RPL. 



PLUM 



Remarks 



ABSOLUTE 
Format 



1. If n is an asterisk, tne otixiAr^ w"" 1 i**» k *w^ 
tion is meaningless and need not occur. 

2. If n is an asterisk, and less than 16 characters are 
specified as the id, the remaining characters of jd 
(up to 16) are space filled. 

3. The name and information cards which follow an 
ADDGEN card have the same meaning and format 
whether ji is an asterisk or a block count. 

4. If n is an asterisk, the ABSOLUTE control instruc- 
tion must appear immediately following the last name 
and information card. 

5. If nis a block count, the ENDGEN control instruc- 
tion must appear immediately following the last 
name and information card. 

6. A macro generator differs from the normal generator 
in that a macro generator can have only one name. 

7. A macro generator is added, replaced, or deleted 
in the same manner as a. normal generator. 

8. When a macro generator is replaced, the macros 
associated with it are not changed except as specified 
by subsequent control instructions. 

Indicates that absolute binary cards are to follow. 



L 


Location 


Command 


Address and Remarks 






ABSOLUTE 


i 



Parameters 
Action 

Remarks 



None. 



1. 



Sets PLUM to convert the subsequent absolute 
binary cards to form the generator RPL. 

The control card is only required when the ADDGEN 
card contains an asterisk as its first parameter in 
the Address and Remarks field. 



2. The next acceptable control card is ENDGEN. 
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ENDGEN 
Format 



Terminates the processing of a generator 



Parameters 
Action 



Remarks 



Example One: 



L 


Location 


Command 


Address and Remarks 






ENDGEN 





None. 

• Terminates generator-processing functions for 
current generator, 

• Gets the next PLUM control instruction. 

Only the following control instructions are acceptable. 

GENTAPE 

ADDMACRO 

ADDSUB 

ADDBRS 

ADDGEN 

DELETE 

REWIND 

ENDALL 

The following control cards will add a three name 
generator six blocks long to the library, from 
TSYSCR4: 



L Location Command Address and Remarks 



GENTAPE TSYSCR4 



ADDGEN 6;GEN$ 



FIRSTGEN 

J;3 

SECNAME 
N;79 

THRNAME 
J;i 

ENDGEN 



Explanation 

Symbolic Tape containing 
the generator. 
Number of RPL blocks to 
be added; identity of 
generator is GEN. 
Multi-name of generator. 
Generator name produces 
a jump; sort # of 3. 
Multi-name of generator. 
Generator name produces 
no jump; sort # of 79. 
Multi-name of generator. 
Generator name produces 
a jump; sort # of 1 . 
Indicates end of name and 
information cards for 
GEN. 



i a on 



PLUM 



Example Two: 



The following control cards w I. add a generator iron, 
absolute binary cards before the rou* re, PLUMRTN: 



L Location Command Address ard Remarks 

ADDGEN *:2RPLGEN 



ABSOLUTE 



ENDGEN 



GENABS; RTN 



N 7 



Explanation 

Ger.eiiioi is to be added 
from abs b.rary cards 
^^ r; r -v of gere-ato- s 

N,m : of generator :o be 
add°d before RTN 
, ' - eio re" op or.) 
(^ r =r a 'or r.ame produces 
r v.. amp sorr ff of 7, 
i.. d d es hat absoiut.e 
b-r-diy c^rds fojiow 
B.raiy cards o be con- 
vened tc RPL. The last 
; .^rd must be a b.nary 
j u mp i ard, 

trdica.es the end of r ame 
ard .rifoTna "on .ardsfor 
2RPLGENA A . 



ADDMACRO 
Format 



Parameter 



Action 



Remarks 



Specifies the name of 'he m*i.'t to be added or replaced- 



L 


Loi at Ion 


Command 


Address and Remarks 






ADDMACRO 


mmF 



name 



3 or fewer axpharume* a characters that comprise 



the name of th^ mac -o 

The m.icro ^ -A be added , :! .- e : d of the string of 
macros wh ch folio* th<=- g«-e:,'Di sa-c fid. unless the 
"before option ,s used, If r.-irr,r ,.i«ady exists on 
oidid, a replacement occurs 



1, The macros immedi,--^ fo.':* the mat ro generator 
with which *.hey are assoc at^d 



2. A macro generator may nc iude \0c'.'> macros 



PLUM 



ENDMACRO 

Format 



Terminates the processing of a macro. 



L 


Location 


Command 


Address and Remarks 






ENDMACRO 





Parameters 
Action 



Remarks 



Example one: 



None. 

• Terminates macro-processing functions for current 
macro. 

• Gets the next PLUM control instruction. 

Refer to remarks of ENDGEN card for acceptable control 
instructions. 

The control cards to add a macro would appear as 
follows: 



L Location Command Address and Remarks 



ADDMARCO TWOMAC 

MACGEN 
R;3 



Explanation 

Name of macro skeleton \c 
be added 

Name of macro generator 
Must start on right 3 ha,f 
words in length (afisr corn ■ 
pilation) . 

Macro skeleton coding 



ENDMACRO 



To add a macro using the "before" option, the control 
cards would appear as follows: 



Example Two: 
L Location Command Address and Remarks 



Explanation 



ADDMACRO ONEAMAC; TWOMAC ONEAMAC to be added before 

TWOMAC 
MACGEN Name of macro generator 

L;2 Must start on left; 2 half- 

words in length (after com- 
pilation) . 
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ADDSUB 



Format 



Parameter 



Action 



Remarks 



Specifies the name of the TAC language subroutine to 
be added or replaced. 



L 


Location 


Command 


1 
Address and Remarks 






ADDSUB 


name 





name - Eight or fewer alphanumeric characters that 
comprise the name of the TACL subroutine. 

The subroutine will be added at the end of the library 
unless the "before" option is used. If name already 
exists on oldid, a replacement occurs. 

1. Subroutines added with the ADDSUB control instruc- 
tion must be terminated by an ENDSUB control 
instruction, 



ENDSUB 



Format 



2. The language of the subroutine to be added is 
assumed to be TACL, 

3. Binary relocatable routines may be included if 
preceded by, first, a BITSBITSBITSBITS card 
(see Example two, for format), and then by a 
binary relocatable PMAX card. 

4. A TACLTACLTACLTACL card (see Example Two, 
for format) must be used to return to TACL mode. 

Terminates the processing of a TAC language sub- 
routine . 



L 


Location 


Command 


Address and Remarks 






ENDSUB 





Parameters 
Action 



None, 

• Terminates processing of the TACL subroutine, 

• Gets the next PLUM control card 



\A-%? 



PLUM 



Remarks 



1. 



The ENDSUB control instruction is recognized 
only when PLUM is in TACL mode (see remarks 
under ADDSUB). 



ADDBRS 



Format 



Parameter 



Action 



Remarks 



2. Refer to remarks under ENDGEN for acceptable 
control cards at this time. 

Specifies the name of a binary relocatable subroutine 
to be added or replaced. 



Location 



Command 



ADDBRS 



Address and Remarks 



name 



R ame " Eight or fewer alphanumeric characters that 
comprise the name of the REL subroutine. 

The indicated subroutine will be added at the end of the 
library, unless the 'before' option is used. If name 
already exists on oldid , a replacement occurs. 

1, Subroutines added with ADDBRS control instruc- 

tlOn are fp rmina ♦■«<-) K^r = ki«3«.. _-l~ i_»_i_ nm 

card. 



4. 



The language of the subroutine to be added is as- 
sumed to be REL, and these routines must be 
preceded by a binary relocatable PMAX card, 

TAC language routines may be included if pre- 
ceded by a TACLTACLTACLTACL card (see 
Example Two, for format). 

A BITSBITSBiTSBiTS card must be used to return 
to REL mode. 



ME 



5. Refer to remarks under ENDGEN for acceptable 
control cards at this time. 

Denotes that the subroutine (TACL or REL) can also 
be entered at the symbolic location specified in the 
address field, 
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Format 



Parameter 



NEST 



Format 



Parameter 



Remarks 



L 


Location 


Command 


Address and Remarks 






ME 


symb 



symb - Eight or fewer alphanumeric characters that 
comprise the multi-entrance of the subroutine. 

Indicates that the TACL or REL subroutine to be 
added calls upon the subroutine specified in the 
address field. 



L 


Location 


Command 


Address and Remarks 






NEST 


name 



name - Eight or fewer alphanumeric characters that 
comprise the name Of the nested subroutine. 

All ME cards must precede NEST cards. 



Example One To add a REL subroutine: 

L Location Command Address t* Remarkt 



ADDBRS 
ME 

NEST 

(PMAX card) 



ALPHA 
ABC 

DEF 



(REL END card) 



Explanation 

Name of subroutine 
Denotes that ABC is another 
entrance to ALPHA 
Denotes that ALPHA calls 
on subroutine DEF 
Binary relocatable routine 
preceded by a PMAX card 
and terminated by an END 
card. When PLUM recog- 
nizes the binary relocatable 
END card, the action of 
the ADDBRS instruction is 
terminated. 

Terminates processing 
of subroutine. 
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Example Two 
L Location 



To add a mixed TACL, REL, TACL subroutine: 
Command Address and Remarks Explanation 



ADDSUB 
ME 
NEST 
NAME 



BETA 

TUV 
WXY 
BETA 



B ITSBITS 



BITSBITS 



T ACLTACL TACLTACL 



DELETE 



Format 



Parameter 

Action 
Remarks 



ENDSUB 



Name of subroutine 
Multi entrance 
Nested subroutine 



TAG language cards 



Binary relocatable cards 
preceded by a PMAX 
card 



TAG language cards 



Deletes a generator, macro or subroutine from the 
library. 



L 


Location 


Command 


Address and Remarks 






DELETE 


name 



name - Eight or fewer alphanumeric characters 

specifying the name of the routine to be deleted. 

name is deleted from the library, 

1. To delete a generator and its multiple names, from 
the library tape, all names must be deleted, 

2. Since a macro generator can have only one name, 
the generator and all its macros are deleted by 
specifying the name of the macro generator,, 

3. Refer to remarks of ENDGEN card for acceptable 
control cards at this time. 

Wrapup Instruction 



ENDALL 



Terminates the PLUM routine and returns control to 
32KSYS. 
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Format 



Parameters 
Action 



L 


Location 


Command 


Address and Remarks 






ENDALL 





None 



An edited listing is produced on TSYSOUT for the 
High-Speed Printer. 

A Console Typewriter typeout indicates the number 
of blocks of the new library (excluding the sentinel), 

Tapes used by PLUM are rewound- 

Return is made to 32KSYS via 1NXTCON. 



CONSOLE 
TYPEWRITER 
NORMAL 
TYPE-OUTS 



Message 

NEW ID 

newid 

nnnnn 



Explanation Action 

IDof library being created. None 

Number of blocks of new 

library. 



CONSOLE 
TYPEWRITER 
ERROR 
TYPE-OUTS 



Message 



NOT LIB 



NOT ID 
oldid. oldid ? 



PLUMDMP 



Explanation 

Tape to be updated is not 
a library tape. 



The ID of the tape to be 
updated does not match 
that specified on the 
OLDLIB control card. 
oldid i is the ID of the 
old library and oldid ? 
is the ID on the control 
card. 

Computer error: dropped 
or picked up a bit ac- 
cording to the mask in 
the Q register. 



Action 

Program halts 
at M/77777. 
Mount tape 
and depress 
ADVANCE. 
This can be 
used only 
once. 

Program halts 
at M/77777. 
Mount new tape 
and depress 
ADVANCE. 
This option 
can be used 
only once. 
Program 
halts at 
M/33333. 
Restart job. 
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PLUM 



CONSOLE 

TYPEWRITER 

ERROR 

TYPE-OUTS 

(Continued) 



Message Explanation 

LIB E n PLUM recognized an 

illegal control card. 
n indicates the type of 
error and is explained 
below. 



Action 

None required. 
Control is 
transferred to 
SYS. 1ENDJ0B, 



ERROR 

PRINTOUTS 



If PLUM detects an error, the card in error along with 
the LIB E n is printed on the system output tape, TSYS- 
OUT is edited for printing on the High-Speed Printer, 

Number Explanation 

1 The initialization control cards are il- 
legal. 

2 While creating a new library, a DELETE 
control card was detected by PLUM, 

3 While creating a new library, an ADDCaRD 
with the "before" option was detected by 
PLUM. 

4 The generator specified to be added to the 
library tape is not on tape specified In 
parameter of GENTAPE control 

5 OLD LIB is not a library tape. 

(1st word of 1st block was rot 'LIBRARY, ") 

6 A semicolon was missing from a control 
card, e.g., J, 3 on a generator control 
card which specifies a jump and sort 
number. 

7 When operating on an ADDGEN "before ' 
PLUM did not detect the routine which 
was specified by the "before" option, 



The N or J, which specifies a jump or 
no jump on a generator control card, 
was missing, 
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PLUM 



ERROR 

PRINTOUTS 

(Continued) 



Number Explanation 

9 When updating an old library, the routine 

specified in a DELETE control card was not 
detected. 

10 When operating on an ADDMACRO "before, " 
PLUM did not detect the macro which was 
specified by the "before" option. 

11 The name specified by the "before" option 
on an ADDMACRO control card was not a 

macro. 



13 



While creating a new library, a macro has 
been added out of the sequence of its macro 
generator. 

While updating an old library, the macro 
generator for an ADDMACRO was not de- 
tected. 



14 When operating on an ADDSUB "before", 
PLUM did not detect the routine which was 
specified by the "before" option. 

15 When operating on an ADDBRS "before", 
PLUM did not detect the routine which was 
specified by the "before" option. 

16 The ID of the library fteing updated does not 
agree with id ol the OLDLIB control card, 

17 A checksum error was detected on a binary 
relocatable card. 

18 Legal control cards at this time are: 
ADDSUB, ADDBRS, ADDMACRO, ADDGEN, 
DELETE, REWIND, or ENDALL. 

19 Working on ADDSUB. Legal control cards 
at this time are: ME, NEST, or NAME. 

20 Working on ADDSUB. Legal control cards 
at this time are: NEST, or NAME. 
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PLUM 



ERROR 
PRINTOUTS 
( Continued) 



Number 



21 



22 



23 



24 



25 



Explanation 

Working on ADDSUB. Legal control cards 
at this time are: ENDSUB, or NAME. 

Working on ADDBRS. Legal control cards 
at this time are: ME, NEST, or PMAX 
card. 

Working on ADDBRS. Legal control cards 
are: NEST or PMAX card. 

Working on ADDBRS. Legal control cards 
are: Binary relocatable end program card, 
ENDSUB, or NAME. 

Working on ADDGEN. Legal card: One 
which specifies the name of a generator In 
the address field. 



26 



27 



28 



29 



30 



Working on ADDGEN, Legal control cards 
are: ENDGEN or a card containing the name 
of generator in address field. 

Working on ADDGEN. Legal card: Jump 
or no Jump; s"ort number in address fieldc 

Working on ADDMACRO: Legal card- 
Name of generator, to which macro is to 
be added, in the address field. 

Working on ADDMACRO. Legal card: Left 
right, or either; number of lines after 
compilation in the address field. 

Working on ADDMACRO, Legal control 
card: ENDMACRO 



31 
32 
33 



The Table of Contents is too large. 

Illegal binary relocatable subroutine card, 

While adding a generator to an old library 
PLUM detected a subroutine or macro with 
the same name. 
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PLUM 



ERROR 

PRINTOUTS 

(Continued) 



Number Explanation 

34 While adding a TACL or a binary relocatable 

to an old library, PLUM detected a macro 
or generator with the same name. 

35 While adding a macro to an old library, 
PLUM detected that the generator specified 
was not a macro generator. 

36 The "before" item specified in an ADDGEN, 
ADDSUB, or ADDBRS control card is a 
macro, or the second or later name of a 
multi-name generator. 

37 The R, L, or E, which specifies right, 
left, or either on a macro input card, was 

missing. 

38 Working on ADDGEN in absolute binary. 
Legal cont-ol cards at this time are: 
ABSOLUTE or spaces in Command Field. 

39 Working on ADDGEN in absolute binary. 
PLUM encountered more than 75 names in 
a multi-name generator. 

40 Working on ADDGEN in absolute binary. 
The only legal card immediately following 
an ABSOLUTE control card is an absolute 
binary card. 

41 Working on ADDGEN in absolute binary. 
The only legal cards at this time are: an 
absolute binary card or a binary jump card. 

42 Working on ADDGEN in absolute binary. 
The only legal cards immediately following 
a binary jump card are: ENDGEN or an 
absolute binary card. 

43 A checksum error was detected on an 
absolute binary card. (This error may also 
indicate that the card is not an absolute 
binary card but appears to be one. ) 
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PLUM 



ERROR 


Number 


PRINTOUTS 




(Continued) 


44 




46 



Explanation 

GENTAPE parameter illegal. 

Illegal control card following a GENTAPE 
card. 



47 No GENTAPE command preceded an ADDGEN 
control card. Generator is added from a 
tape not used before. 

48 Illegal parameter (minus sign) found on 
control card. 



Error Exit 



Following detection and indication of a PLUM error, 
control is transferred to SYS. 1ENDJOB. 
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RPLC SERVICE ROUTINE 



FUNCTION 



SERVICE 
ROUTINE 
INITIATION 



INPUT -OUPUT 
SYSTEM 



Revises the contents of a tape by adding, deleting, or 
correcting RPL programs. 

The RPLC service routine may be called into operation by 
the following instruction: 



L 


Location 


Command 


Address and Remarks 






RPLC 





32KSYS XORD is used for all tape operations. 



CONTROL 
INSTRUCTIONS 



RPLC accepts the following written in standard 32KSYS 
control line format: 



Inst ruction 



Function 



NEWTAPE 



Specifies the tape onto which the up- 
dated information is to be written. 



REWIND 
COPY 

COPYTIL 

SKIPTIL 



Rewinds tapes. 

Transfers information to the output 
tape specified by NEWTAPE. 

Transfers information until a desig- 
nated RPL program is encountered. 

Bypasses all information until a 
designated RPL program is encoun- 
tered. 



DELETE 

ADD 

WRTSENT 



Copies all information until a desig- 
nated RPL program is encountered, 
and then bypasses the program. 

Adds a program in RPL format, 

Writes a sentinel block on tape. 
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RPLC 



CONTROL 

INSTRUCTIONS 

(Continued) 



Instruction 

LOCSENT 
CORRECT 

IDCHANGE 



INDEX 

END 
END ALL 



Function 

Locates a sentinel block on tape. 

Makes corrections to an RPL, and 
transfers it to the output tape. 

Copies all information on an input tape 
until a designated RPL program is en- 
countered, makes corrections to that 
program and transfers it to the output 
tape IDCHANGE also changes the RPL 
ID. 

Writes index block(s) on NEWT APE 
that contain ID's of all programs en 
NEWTAPE to this point. 

Terminates individual program cor 
rection. 

Terminates the RPLC routine and re- 
turns control to SYS. 



The functions of REWIND, LOCSENT, and WRTSENT are 
as described in TAPE HANDLING. 



NEWTAPE 



Specifies the magnetic tape onto which the updated in- 
formation is to be placed. 



Format 



Remarks 



COPY 



L 


Location 


Command 


Address and Remarks 






NEWTAPE 


t, 



_t_- The symbolic tape (except TSYSTEM, TSYSOUT, and 
TSYSIN) which is to be the output tape. 

NEWTAPE must precede all other control instructions 
except REWIND. 

Copies all information from an input tape onto the output 
tape. 



Format 



L 


Location 


Command 


Address and Remarks 






COPY 


t, sent j 
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RPLC 
Parameters 



Action 



t - The symbolic tape whose contents are to be copied. 

sent (OPTIONAL) - The sentinel word to be used in lo- 
cating a sentinel block, 

• All information on t beginning at the point where _t is 
currently positioned, is copied onto the output tape 
until a sentinel block of sent is encountered. 

• If sent is omitted, a sentinel block of Z's will ter- 
minate the copy action. 

• When the sentinel block is encountered, _t is positioned 
immediately following the sentinel block. 



Example 



L Location Command Address and Remarks 



COPY 



ALPHA, AAAAAAAA 



Explanation: Execution of this instruction causes all in- 
formation on Tape ALPHA to be copied onto the output 
tape until a sentinel block of A's is encountered. 



COPYTIL 



Format 



Parameters 



Action 



Remarks 

14-44 



Copies information from an input tape onto the output tape 
until a specified RPL program is encountered. 



L 


Location 


Command 


Address and Remarks 






COPYTIL 


t, id 



t - The symbolic tape whose contents are to be copied. 

id (OPTIONAL) - The ID of the RPL program to be lo- 
cated. Omitting this parameter is equivalent to speci- 
fying the ID of the next RPL on the tape. 

• All information on t, beginning where t is positioned, 
is copied onto the output tape until RPL program id 
is encountered. 

• Upon completion of the copy, t is positioned at the 
start of the RPL program id. 

The RPL Program id is not copied. 



RPLC 



SKIPTIL 



Format 



Bypasses all information on an input tape until a specified 
RPL program is encountered. 



L 


Location 


Command 


Address and Remarks 






SKIPTIL 


t, id 



Parameter! 
Action 



Same as COPYTIL. 

• All information on t, from where t_ is positioned, is 
passed over until the RPL program id is encountered. 

• When id is located, _t is positioned at the beginning of 
that program. 



DELETE 



Format 



Copies all information from an input tape onto the output 
tape until a specified RPL program is located. That pro- 
gram is then bypassed. 



L 


Location 


Command 


Address and Remarks 






DELETE 


t, id 



Parameters 
Action 



Same as COPYTIL. 

• All information on t, from where t is currently posi- 
tioned, is copied onto the output tape until the RPL 
program id is encountered. 

• id is bypassed and t is positioned at the end of the pro- 
gram or immediately following the sentinel if one were 
encountered. 



ADD 



Format 



Bypasses all information on an input tape until a specified 
RPL program is located. That program is then copied 
onto the output tape. 



L 


Location 


Command 


Address and Remarks 






ADD 


t,W 
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RPLC 



Parameters 



Action 



CORRECT 



t - The symbolic tape on which the RPL program is con- 
tained, or an asterisk (*) which indicates that the 
ABS deck which follows is to be added to the output 

LdpC 111 KrjJ iummi. 

id - The identity of the RPL to be added. 

• If t is a symbolic tape, information on_t, from where 
t is currently positioned, is bypassed until the RPL 

"program id is encountered. The program is then 
copied to~the output tape. _t is positioned at the end of 
the program added or immediately following the senti- 
nel if one were encountered. 

• If t is an asterisk ('-), the information from the ABS 
cards whjch immediately follow, is converted to RPL 
format and copied to the output tape. 

1. If t is an *, id is an optional parameter, if a PMAX 
card precedes the ABS deck. 

2. If both id and a PMAX card are present, the identity 
of the RPL is taken from the PMAX card. 

Copies all information from an input tape onto the output 
tape until a specified RPL program is located. Correc- 
tions are made to that program and it is copied onto the 
output tape. 



Format 



L 


Location 


Command 


Address and Remarks 






CORRECT 


t, id 



Parameters 
Action 



Same as ADD. 

• If t is a symbolic tape, information on t from where t 
is currently positioned, is copied onto the output tape 
until the RPL program id is encountered. 

• id is copied onto the output tape, and the corrections 
(which follow the CORRECT instruction) are added as 
separate RPL sections prior to the end of the RPL. 

• t is positioned at the end of the program or immedi- 
ately following a sentinel if one were encountered. 
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If t is an asterisk (*), see Action under ADD. In 
addition, the corrections (which follow the ABS END 
card) are added as separate RPL sections prior to 
the end of the RPL. 



Corrections 



Corrections to an RPL program appear immediately after 
the CORRECT or IDCHANGE control instructions, except 
where t in the CORRECT instruction is an asterisk (*). 



Format 



Parameters 



L 


Location 


Command 


Address and Remarks 


P 


ml 


instr 


n? 2 



p - An alphabetic character, L or R, which indicates 
whether the change is to start in the left or right 
half of the word specified by m\. If omitted, L is 
assumed. 



L 
R 



Specifies the left instruction 
Specifies the right instruction 



mi - An octal address, written in the Location field, which 
indicates the location of the first word to be changed. 
If consecutive instructions or locations are to be cor- 
rected, the label and location of only the first need be 
specified. 

instr - The new word constant (W/), octal constant (O/), 
or command part of a new instruction. Word con- 
stants may be eight or fewer alphanumeric characters. 
If fewer than eight characters are used, the constant 
is assumed to be left -justified and right-filled with 
spaces. Octal constants must contain exactly 16 digits. 
The command part of a new instruction is written as a 
standard TAC mnemonic. 



Remarks 



m_2 - An octal address. If indexed, the form must be; 
val , i where val is an octal number from 0-7777 and 
i is a number from 0-7. 

Only one correction per card is permitted. 



i<i-t i 



RPLC 



END 



Format 



Parameters 
Remarks 



Terminates the individual program correction. 



Location 



Command 



END 



Address and Remarks 



None, 



An END instruction must be used to terminate the correc 
tion procedure whether the _t parameter of the CORRECT 
instruction is a symbolic tape or an asterisk (*). 



IDC HANG E 



Format 



Parameters 



Action 



Remarks 



Same as CORRECT. In addition, the identity of the cor- 
rected RPL is changed. 



L 


Location 


Command 


Address and Remarks 






IDC HANG E 


t_,id 



t - The symbolic tape containing the RPL program, 
id - The identity of the RPL to be corrected. 

• Information on t, from where t is positioned, is copied 
onto the output tape until the RPL program id is en- 
countered, 

• The Action for the CORRECT instruction applies, ex- 
cept that the ID of the corrected RPL program has 
been changed as specified by the first correction card. 

The first correction following the IDCHANGE instruction 
must be the new ID. An I is written in the Label column 
and the new ID is written in the Command and Address and 
Remarks fields. 



Example 



Location 



Command 



Address and Remarks 



IDCHANGE ALPHA, PROGRAMl$ 

PROGRAM2 

END 
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Explanation; Execution of these instructions causes all 
information on Tape ALPHA to be copied onto the output 
tape until RPL program PROGRAM1 is encountered, Wher 
located, the old ID is replaced by PROGRAM2 and is copie 
onto the output tape. If there had been any other correc- 
tions, they would have been treated in the same manner as 
effected by the CORRECT control instruction, RPLC then 
requests its next control instruction. 



INDEX 



Writes an index block(s) onto the output tape that contains 
the ID's of all RPL programs already existing on NEWTAP 



Format 



Location 



Command 



INDEX 



Address and Remarks 



PARAMETERS 
ACTION 



None. 



The word ***INDEX is placed in Words and i of ih^ 
first index block. Succeeding blocks, if any, are not 
identified with : * : '' INDEX. 



ID's of all RPL's on me output tape are transferred to 
the output block following the '""INDEX identification 

When all ID's have been transferred, a sentinel word 
of 48/1's is placed in the output block following the 
last ID. 



REMARKS 



Index blocks that already exist on an input RPL tape. 
are updated byRPLC when transferred to the output 
tape. 



Index blocks can only be deleted by using RPLC con- 
trol instructions to position the input tape around the 
index blocks. 



ENDALL 



Format 



Terminates the action of the RPLC service routine and 
turns control to 3ZKSYS. 



Location 



Command 



ENDALL 



Address and Remarks 



list, sent, pos 
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PARAMETERS 



ACTION 



list (OPTIONAL) - Causes a list of the ID's of all RPL pro- 
grams transferred to the output tape to be edited and 
written on TSYSOUT. 

sent (OPTIONAL) - The sentinel word to be used in writing 
the sentinel blocks. 

pos (OPTIONAL) - An alphabetic character that specifies 
the position of the output tape. If the parameter is 
omitted, the tape is positioned after the first sentinel 
block. 

L Specifies that the output tape is to be rewound 
with lockout. 

R Specifies that the output tape is to be rewound. 

• Two sentinel blocks of Z's or the configuration speci- 
fied by sent are written onto the output tape. 

• If LIST is specified, a listing of the ID's of all RPL 
programs transferred to the output tape is edited and 
written on TSYSOUT. If list is omitted, no listing 
will be processed. 

• The output tape is positioned according to pos. 

• Control is returned to 32KSYS via 1NXTCON. 



RPLC 
SERVICE 
ROUTINE 
EXAMPLE 



L_ 


Location 


Command 


Address and Remarks 






RPLC 




(1) 






REWIND 


NEWRPL, TAPE 10, 
TAPE ii, TAPEi2 


(2) 






NEWTAPE 


NEWRPL 


(3) 






COPYTIL 


TAPE 10, HOMER$ 


(4) 






ADD 


TAPE11,ALPHA$ 


(5) 






CORRECT 


TAPE12,GAMMA$ 


(6) 


L 


14063 


TMA 


11075 


(7) 


R 


15321 


TDXL 

END 


4,5 


(8) 
(9) 






COPY 


TAPE 10, AAAAAAAA 


(10) 






ENDALL 


LIST 


(11) 
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Explanation: Execution of these instructions causes the 
following action to take place: 

1. RPLC is called into operation 

2. Tapes NEWRPL, TAPE 10, TAPE 11, and TAPE 12 
are rewound. 

3. Tape NEWRPL is specified as the final output tape. 

4. All information on TAPE 10 is copied onto tape 
NEWRPL until RPL program HOMER is encountered. 
Tape remains positioned at the beginning of program 
HOMER. 

5. All information on TAPE 11 is bypassed until RPL 
program ALPHA is encountered. ALPHA is copied 
onto NEWRPL. Tape 11 remains positioned at the 
beginning of the next block past ALPHA. 

6. All information on TAPE 12 is copied onto NEWRPL 
until RPL program GAMMA is encountered. 

7. GAMMA is copied onto NEWRPL and the TMA in- 
struction is inserted as a separate RPL sectio.i at 
the end of GAMMA. At load time it will overlay 
location 14063Lg of program GAMMA. 

8. The TDXL instruction is inserted as a separate RPL 
section following the RPL section referred to in step 
7. At load time, it will overlay location 15321R fi of 
program GAMMA. 

9. The END instruction signifies the end of corrections. 



10. 



All information on TAPE 10 beginning with RPL pro 
gram HOMER, is copied onto NEWRPL, until a 
sentinel block of A's is encountered. 



11. Two sentinel blocks of Z's are written on NEWRPL, 

and a list of the ID's of all RPL programs transferred 
to the output tape is edited and written on TSYSOUT. 
The output tape is positioned after the first sentinel 
block, and control is returned to 32KSYS via INXTCON. 
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ERRORS 



Type -Out 



RPLC El 






RPLC E3 
RPLC E4 

RPLC E5 

RPLC E6 

RPLC E7 

RPLC E8 

RPLC E9 

RPLC E10 
RPLC Ell 
RPLC E12 



Print -Out 

ILLEGAL CONTROL CARD 
TAPE SPECIFIED IS NEWTAPE OR IS 
A RESERVED SYSTEM TAPE 
NEWTAPE HAS NOT BEEN SPECIFIED 
SENTINEL BLOCK PREVENTED COM- 
PLETION OF FUNCTION j 
THE CARD FOLLOWING "IDCHANGE" 
CONTROL IS NOT AN "I" CARD 
RPLC IS NOT GOOD - ILLEGAL SEC- 
TION WORD 
ILLEGAL CORRECTION CARD 

(CARD IGNORED) 
MORE THAN 8 CHARACTERS IN 
SENTINEL PARAMETER 
ID IS MISSING ON ADDITION OR COR- 
RECTION OF AN ABS DECK 
CHECKSUM ERROR ON ABS CARD 
ILLEGAL BINARY CARD IN ABS DECK 
ILLEGAL PARAMETER IN ENDALL 
CARD 



Error Exit 



Following detection and indication of an RPLC error, con- 
trol is transferred to SYS. 1ENDJOB. 
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FUNCTION 



SERVICE 
ROUTINE 
INITIATION 



TACSERV SERVICE ROUTINE 



Copies TAC language information from one magnetic tape 
to another, adding, deleting, or replacing cards or pro- 
grams during the process. 

The TACSERV service routine may be called by the follow- 
ing instruction: 



L 


Location 


Command 


Address and Remarks 






TACSERV 





INPUT 
REQUIREMENTS 



INPUT -OUTPUT 
SYSTEM 

CONTROL 
INSTRUCTIONS 



Information on the input tape must be in TAC language 
format in Code Mode, 10 words per card, 12 cards per 
block. Each program on the tape must contain an I card 
as the first card of the first block, and an END card as 
the final card of the program. An I card contains an I in 
Column 9, while Columns 10 through 16 are blank. 



TACSERV uses 32KSYS XORD for all reads, writes, 
tape movements. 



and 



TACSERV accepts 22 control instructions, written in 
standard 32KSYS control line format. The instructions 
are grouped into two classes - Class I and Class II - pre 
ceded by a mandatory initialization instruction, NEWTAPE. 
Class I instructions provide program -by-program and 
tape movement operations, while Class II instructions 
provide card-by-card operations for revision of TAC lan- 
guage programs. Class II is initiated by the CORRECT 
instruction and is usually terminated by the ENDPROG 
instruction. 

The 22 TACSERV control instructions are; 



Instruction 
NEWTAPE 



ADDPROG 



Class Function 

I Initiation control card which 

assigns the output tape, 

I Transfers a specified pro- 

gram without change from an 
input to the output tape. 
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Instruction 



Class 



Function 



COPY 



Transfers information with- 
out change to the output tape 
until a specified sentinel 
block is encountered. 



COPYTIL 



Transfers information with- 
out change to the output tape 
until a specified program is 
encountered. 



CQRRECT 



Transfers information with- 
out change to the output tape 
until a specified program is 
encountered, and sets 
TACSERV to the Class II mode 
(individual program correc- 
tions). Program correction 
instructions (Class II) must 
follow. 



DELPROG 



Deletes a specified program 
from an input tape. 



ENDALL 



Terminates the TACSERV 
routine and returns control to 
32KSYS. 



LOCATE 



LOCSENT 



Searches for a specified pro- 
gram on an input tape. 

Searches for a specified 
sentinel block on an input 
tape. 



REWIND 



Rewinds one or more magne- 
tic tapes. 



REWINDLO 



SENTINEL 



Rewinds with lockout one or 
more magnetic tapes. 

Designates an ending sentinel 
block. 



WRTSENT 



Writes a sentinel block on a 
specified tape. 



TACSERV 



The functions of REWIND, REWINDLO, LOCSENT, and 
WRTSENT are as described in TAPE HANDLING SEC- 
TION. 



Instruction 
ADD 

DELETE 

DELADD 
ENDPROG 



Class Function 

II Adds one or more cards to a 

program. 

II Deletes one or more cards 

from a program. 

II Deletes and adds cards, 

II Terminates individual pro- 

gram corrections, and resc* 
TACSERV to Class I mode. 



LOCSEQ 



LOCFLAD 



NOSEQ 



REPLACE 



SEQ 



II 



II 



II 



II 



II 



Sets TACSERV to search for 
cards by sequence number. 

Sets TACSERV to search for 
cards by symbolic address. 

Halts assignment oi new se- 
quence numbers within a pro- 
gram. 

Replaces one or more cards 
in a program. 

Assigns new sequence num- 
bers to cards within a program. 



NEWTAPE 
Format 

Parameter 



Assigns the output tape. 



L 


Location 


Command 


Address and Remarks 






NEWTAPE 


t 



t - The symbolic tape except system reserved tapes, 
which is to be the output tape. 



TACSERV 



Remarks 



CLASS I 
INSTRUCTIONS 



ADDPROG 



Format 



1. NEWTaPF mi. st precede a ! 
tions t.aept REWIND. 

2. X m 3. v. * n o T V. t- \ 1 3 1? ci )■ o t 3. p ■ 
"except REVV.'ND, 



tr IACSERV Instruc 



•,tr.,-r TACSERV instruct- on 



Class i instruc -.ions perform all i en 'ions of the service 
routine except '^dividual program corrections. TACSERV 
is preset to tiu: Cih^ ; mod' by 'i->- execution, of the 
NEW TAPE, c. •."■!' {•••] "0 llA i )i „ Ofiv C-.Uss J instructions 
maybe issued m M>is mode :'". H v'di^ program correc- 
tions^ . 

Transfers a piotrr.o.m itJii' -if; imh ■'. •.ape t < the output 
tape. 



L I Loca'ion 

-H 



C;niima.iil j Add ■■ ess and Remarks 
ADDPROG ! T, ') 



Parameters 



t - The symbol c tape from wlndi a program is to be 
transferred. 



Ac tion 



i.d - The identitv of T .he prog/ am To be Jdded. 

Note. An asterisk ■!■ spech'ed ; .n place of t, id 

.nclh ates tea' a I ACL - ^ ret deck follows 
the ADDPROG control card and '.s to be 
written onto the oat out tape. 

• All information on t ;r or, wcc-ic t is p/jsiticned. is 
bypassed until the TALL prrgrar' :d is encountered. 

• The program identified o\ id s c jpied onto the out- 
put tape and t <s posiuont a a» 'he beginning of the 
next bios k fol Lowing iha 1 program. 



If ADDPROG is spe< o; 



i the i.ards fcTlowing 



that control i -jrd, up to acv.l on hiding the first END 
carl encountered, are trail;. .!«.- < rt. d to the output tape. 

If tne sen.1i.ueL bejel-: is e< >ee.i.. i tol ei ' >r to the pro • 
gram id, error pi. 4 < *< 1 i r e s ij ; t „ 
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Example 



Location Command Address and Remarks 

ADDPROG TSYSCRO, NAME 1$ 



Explanation: Execution of this instruction causes all in- 
formation on TSYSCRO beginning at the point at which the 
tape is currently positioned, to be bypassed until TACL 
program NAME 1 is encountered. Program NAME 1 is 
then copied onto the output tape and TSYSCRO is positioned 
at the start of the next block following program NAME 1. 



COPY 



Transfers without change all information from an input 
tape onto the output tape until a specified sentinel is lo 
cated. 



Format 



L 


Location 


Command 


i 
Address and Remarks j 






COPY 

i 


t, sent j 



Parameters 



t - The symbolic tape to be copied. 



sent (OPTIONAL) - The sentinel word to be used in !o 
eating a sentinel block. The sentinel specified by a 
COPY instruction overrides a previously -spec fied 
sentinel for the duration of that COPY instruction. 
If sent is omitted. Z's are assumed. 



Action 



• All information on t, from where t is positioned is 
copied onto the output tape until the sentmei block 
is encountered. 



The sentinel block is not copied onto the output tape 
and_t is positioned at the start of the next block fol 
lowing the sentinel block. 



Example 



Location Command Address arid Remarks 



COPY 



T-024., AAAAAAAA 



Explanation: Execution of this instruction causes all in- 
formation on Tape T-024;, beginning at the point at which 
the tape is currently positioned, to be copied onto the 
output tape until a sentinel block of A's is encountered. 



14 5 7 



TACSERV 

COPY TIL 



Format 



Parameters 



Action 



Transfers without change all information from a desig- 
nated input tape to the output 'ape until a specified pro- 
gram is encountered. 



L 


Location 


_______ — 

Command 


■ 

Address and Remarks 






COP^ TIL 


t. id 



t - The symbolic tape to be coped 

id - The identity ot the program to which the tape is to be 
copied, 

• All information on t. from where_t_is positioned, is 
copied onto the output tape unt . i program k! is encoun- 
tered. 

• t is positioned at the beg.nmng ot program id_. 

• H the sentinel block is encountered prior to program 

irl lTT-T-r>T-Tr , 4-\x/i1lr«=>£!iilT. 



Example 



L Location Command Address and Remarks 

COP^TiL T85.GAMMA $ 



Explanation Execution oi th.s instruct. on causes tape 
T85, beginning at the point a* which it is currently posi- 
tioned, to be copied onto the output tape until program 
GAMMA is encountered. The tape s pos.tioned at the 
start of GAMMA. 



CORRECT 



Format 



Parameters 
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Sets TACSERV to the Class i.i mode (individual program 
corrections'!. 



L 


Location 


C "> mm a. rid 


Address and Remarks 






CORRECT 


t,id 



t - The symbolic tape to be coped. 

id (OPTIONAL) The identity of the program to be cor- 
rected. The id parameter may be omitted if the tape 
is ore -positioned. 



TACSERV 



Action 



All information on t, from where t is positioned, is 
copied onto the output tape until program id is en- 
countered. 



t is positioned at the beginning of the designated pro- 
gram. 

If id is omitted, corrections will be made froin the 
point at which the input tape is currently positioned. 

TACSERV is set to accept Class II instructions only, 

TACSERV i s S et to search for cards m the LOCFLAD 
mode (by symbolic location). (Refer to LOCFLAD ) 

If the specified sentinel block is encountered prior to 
program id Error E4 will result. 



Remarks 



The Class II mode is terminated by the execution of 
ENDPROG control instruction. 



Example 



L Location Command Address and Remarks 



CORRECT OLDTACL, ZEBRA $ 



formation on Tape OLDTACL, beginning at the point at 
which the tape is currently positioned, to be copied, onto 
the output tape until program ZEBRA is encountered. 
The tape is positioned at the start of program ZEBRA. 
Class II instructions must follow. 



DELPROG 
Format 



Deletes a specified program. 



L 


Location 


Command 


Address and Remarks | 






DELPROG 


t, id 



Parameters 



_t - The symbolic tape from which the program is to be 
deleted. 



id - The identity of the program to be deleted. 
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TACSERV 

Action 



Example 



» t, from where t is positioned, is copied onto the out- 
put tape until program id is encountered. 

i Program id is not copied onto the output tape, but is 
bypassed and the tape is positioned at the beginning 
of the block following the program or immediately 
following the sentinel block, if one were encountered. 

• If the sentinel block is encountered prior to the pro- 
gram designated by id Error E4 will result. 

L Location Command Address and Remarks 

DELPROG T72 : YOKE $ 



Explanation: Execution of this instruction causes all in- 
formation on Tape T72, beginning at the point at which 
the tape is currently positioned, to be copied onto the out- 
put tape until program YOKE is encountered. Program 
YOKE is not copied onto the output tape, but is bypassed 
and the input tape is positioneu at tue start Oi tn.e next 
block following the program. 



ENDALL 
Format 



Terminates the TACSERV service routine. 



Parameters 



L 


Location 


Command 


Address and Remarks 






ENDALL 


list, sent, pos 



list (OPTIONAL) - Produces a listing on TSYSOUT of the 
ID and block count of each program on the output 
Tape, plus the total block count including sentinels. 

sent (OPTIONAL) - The sentinel word to be used in writing 
the sentinel blocks. If sent is omitted, Z's are assumed. 

pos (OPTIONAL) - An alphabetic character that specifies 
the position of the output tape. If the parameter is 
omitted, the tape is positioned after the first sentinel 
block. 

L Specifies that the output tape is to be rewound 
with lockout. 



R 



Specifies that the output tape is to be rewound. 
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Action 



TACSERV 

Two sentinel blocks of Z's or the configuration speci- 
fied by sent are written onto the output tape. 

If LIST is specified, a listing of the ID and block 
count of each program on the output tape, plus the 
total block count including sentinels, will be produced 
for printing on the High-Speed Printer. If LIST is 
omitted, no listing will be processed. 

The output tape is positioned according to the pos 
parameter. 

Action of the TACSERV routine is terminated and con- 
trol is returned to 32KSYS via 1NXTCON. 



LOCATE 



Search for a designated program on an input tape, 



Format 



L 


Location 


Command 


Address and Remarks 






LOCATE 


t, id 



Parameters 



t - The symbolic tape on which the designated program is 
located. 






Id. - ine lueniuy uf the prugrdin iu tie lucateu. 



Action 



t is searched for program id. 



Example 



• When program id is encountered, the tape is posi- 
tioned at the start of the program, 

• If the sentinel block is encountered prior to program 
id, Error E4 will result. 

L Location Command Address and Remarks 



LOCATE 



T-024 : XRAY $ 



Explanation: Execution of this instruction causes Tape 
T-024 to be searched for program XRAY and the tape to 
be positioned at the start oi that program. 
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SENTINEL 
Format 



Parameter 



Action 



Remarks 



CLASS II 

INS TR UC TIONS 



TRANSFER OF 
DATA 



Designates an ending sentinel block. 



L 


Location 


Command 


Address and Remarks 






SENTINEL 


sent 



sent - The sentinel word to be used in locating the sentinel 
block. 

• There is no immediate action. TACSERV is set so 
that the operation of all subsequent instructions - 
prior to another SENTINEL instruction - will be ter- 
minated whenever a sentinel block of sent is encoun- 
tered. 

If the SENTINEL control instruction is omitted, a sentinel 
block of 120 words of Z's will be assumed by TACSERV 
for termination of subsequent instruction action. 

Class II instructions perform individual program correc- 
tions such as the addition, deletion, or replacement of 
cards. TACSERV is set to accept Class II instructions 
by the execution of the CORRECT instruction. Only Class 
II instructions may be issued in this mode; otherwise, 
Error El will result. 

Only one program may be processed for each CORRECT 
instruction. Corrections to a program must be made in 
the sequential order of the program cards. 

This mode is terminated by the processing of an ENDPROG 
card. 

Whenever an ADD, REPLACE, DELADD, or DELETE in- 
struction is executed, information is transferred either 
from the beginning of the program being corrected, or 
from the point of last change in that program (via a previ- 
ous ADD, REPLACE, DELADD, or DELETE instruction) 
to the point at which cards are to be currently added, re- 
placed, or deleted. Whenever the ENDPROG instruction 
is executed, the balance of the program is transferred 
from the input tape to the output tape, and the Class II 
phase is terminated. 
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ADD 

Format 
LOCFLAD 

mode 



Parameters 

LOCFLAD 

mode 



Adds one or more cards to a program. 



L 


Location 


Command 


...... ... 

Address and Remarks 






ADD 




symb, n, total 

- 



symb - The symbolic location used with ji that designates 
the card in front of which the new cardfs) are to 
be added. 



n - A decimal number that indicates the number of card 
beyond symb, ahead of which the cards are to be 
added, if n_ is zero, the card identified by sjfrnb 
is the one ahead of which the new cards will he 
added. 



Format 

LOCSEO 

mode 



Parameters 

LOCSEO 

mode 



total (OPTIONAL) - The number (decimal) of consecutive 
cards to be added If total is omitted, cards> wii>. 
be added until a TACSERV Class 11 instruction is 
encountered. 



L 


Location 


Command 


Address and Remarks 






ADD 


xxxxxxxx, total 



xxxxxxxx - The eight-charai ter idem ry and Sequent e 
field of the card in fror.t of which new i ards are 
to be added. 



total (OPTlONALj - See description under LOCFLAD 
mode. 



Action 



The TACL program specified by the most rei ent 
CORRECT conzioi instruction is copied card-by - 
card onto the output tape until the specified card 
is encountered. The specified card <s not trans- 
ferred to tha output tape and remains available 
for further processing. 

The cards to be added are written onto tne output 
"ape- The next TACSERV control instructor, ss 
then requested. 
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Remark* 1. Cards are always added preceding the card 

specified by aymb + n in LOCFLAD mode or 
xxxxxxxx in LOCSEQ mode. 

2. If symb is blank or zero, cards will be added 
immediately preceding the nth card beyond the 
one last affected by an ADD, DELADD, DELETE, 
or REPLACE instruction for this program. If 
there were no such previous instructions, the 
cards will be added prior to the nth card from 
the beginning of the program. 

3. If symb and n are both zero, the current location 
on the input "tape is assumed. 

4. The cards to be added must immediately follow 
the ADD control instruction. 

5. If an END card is added, it must be followed by 
an ENDPROG card. Cards between the END card 
being added and the ENDPROG card will be 
ignored. 

ADD Example Assume that two instructions are to be added in 

LOCFLAD mode LOCFLAD mode, between the third and fourth instruc- 

tions of the following coding: 

L Location Command Address and Remarks 

TEST CA 

SLAO 6 

TMD W/00000001 

JMP START 

The following TACSERV instructions are used to add 
the new cards: 

L Location Command Address and Remarks 

ADD TEST, 3,2 

JAED (P) + 2H 

AM ZEBRA 
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Execution of the TACSERV instruction ADD causes 'he 
preceding portion of the program, from either its be- 
ginning or point of last change to the JMP START card 
(the card indicated by TEST +3; to be written onto the 
output tape, At this point, the t^o cards following ADD 
are written following the TMD W/ 00000001 card on the 
output tape. The input tape remains positioned at the 
JMP START card. 

The corrected portion of the program on the output 
tape now appears as 

L Location Command Address and Remarks 



TEST 


CA 






SLAQ 


6 




TMD 


W/ 00000001 




JAED 


<P) *2H 




AM 


ZEBRA 




JMP 


START 



ADD Example 
LOCSEO mode 



Assume that two instructions are to be added in 
LOCSEO mode preceding the fourth instruction of the 
coding below. 



Identity 

and Sequence 


_L 


Lot 


at 


ion 


Commas 


»d 


Address and Remarks 


XRAY0012 
XRAY0013 
XRAY0014 
XRAY0015 










CA 

SLAQ 
TMD 
JMP 




6 

W/00000001 

START 



The following TACSERV instructions are used to enter 
the new cards: 



Identity 


L 


Location 


Command 


Address and Remarks 


and Sequence 










ADD 


XPAY0015 








JAED 


(P) * 2H 








AM 


ZEBRA 








ENDPRQG 





Execution of the TACSERV instruction ADD causes the 
preceding portion of the program, from either its 
beginning or point of last change up to. but not including 
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card XRAY0015 (JMP START), to be written onto the 
output tape. At this point, the two cards following ADD 
are written following the TMD W/00000001 card onto 

Lilt; UUIUUU A-* 1 1 l~~f A -J- VV>* VJ HIUH_d w"o *.*S * * ■ ^-' *-* "■—* -* » " w*t*v 

there are no further corrections to be made to this pro- 
gram, and the remainder of the program is transferred 
to the output tape. 



The corrected portion of the program on the output tape 
now appears as: 



Identity 

and Sequence 



Location Command 



Address and Remarks 



XRAY0012 
XRAY0013 
XRAY0014 



XRAY0015 



CA 

SLAO 

TMD 

JAED 

AM 

JMP 



W/00000001 
(P) H 2H 
ZEBRA 
START 



DELADD 



r ormat 

LOCFLAD 

mode 



Deletes one or more cards from a TACL program, then 
adds cards until the next TACSERV control is encountered. 



L 


Location 


Command 


Address and Remarks 






DELADD 


symb, n, total 



Parameters 

LOCFLAD 

mode 



symb - The symbolic location used in conjunction with 
_n_that designates the first card to be deleted. 

ji - The number (decimal) of cards past the card 
(designated by symb ) of the first card to be 
deleted. If _n_ is zero, the card identified by 
symb will be the first to be deleted. 



Format 

LC&CSEQ 

mode 



total (OPTIONAL) - The number (decimal) of cards to 
be deleted. If total is omitted, one card will be 
deleted. 



L 


Location 


Command 


'■ ■■■ ■■ ■■ -i 
Address and Remarks 






DELADD 


XXXXXXXX, total 
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Parameters 

LOCSEO 

mode 



Action 



Remarks 



DELADD Example 
LOCFLAD mode 



XXXXXXXX - The eight-character Identity and Sequence 
field of the first card to be deleted. 

total (OPTIONAL) - The number (decimal) of cards to 
be deleted. If total is omitted one card will be 
deleted. 

• The TACL program designated by the most recent 
CORRECT instruction is copied card-by-card onto 
the output tape until the specified card is encountered, 

• Cards are transferred from TSYSIM to the output 
tape until a TACSERV Class II instruction is en- 
countered. Then the total number of cards start- 
ing with the specified card is deleted. 

1. If symb is blank or zero, cards will be deleted 
from the _nth card beyond the last am referenced 
in a previous ADD, DELADD, DELETE or RE- 
PLACE instruction for this program. If there 
were no such previous instructions, cards will be 
deleted from the nth card of the program. 

I. If symb and n are both zero, the current location 
on the input tape is assumed. 



3. 



The process ing of an END card will terminate the 
DELADD function. If the END card is detected 
during the delete phase, Error Ell will result. 



Assume that the third and fourth instructions are to be 
deleted in LOCFLAD mode from the following coding, 
and three instructions are to be added. 



L Locati 



ion 



TEST 



Command 


Address and Remarks 


CA 




SLAO 


b 


TOD 




JMP 


OUT 


TMD 


W/ 000000 01 


JAED 


(P) + zu 


AM 


ZEBRA 


JMP 


START 



TACSERV 



The following TACSERV instruction is used to delete 
the two instructions and add three In their place, 

L Location Command Address and Remarks 



DELADD 
TOM 
TMO 
JMP 



TEST 2,2 

ERR 

MASK! 

OUT A 



Execution of the TACSERV irsr.ruction DELADD causes 
the preceding portion of the program, from either its 
beginning or point of last change up to but not including 
the TQD instruction, to be written on the output tape. 
At this point, the TOD instruction and the one immediately- 
following it are bypassed or the input tape and the tape is 
positioned at the TMD W/0000000! card. 

The corrected portion of the program on the output tape 
now appears as: 

L Location Command Address and Remarks 



TEST 



CA 




SLAO 


6 


TOM 


ERR 


TMO 


MASK! 


JMP 


OUT A 



dklete 

t' or mat 
LOG F LAD 
mode 



The card TMD W / 00000001 and those following remain 
on the input tape and are available for further process- 
ing. 

Deletes one or more cards from a TACL program. 



L 


Location 


Command 


Address and Remarks 






DELETE 


symo r, total 





Parameters 

I..OCFLAD 
mode 



symb - The symbolic location used in conjunction with 
n_ that designates the first card to be deleted. 

_n - The number (decimal) of Lards past the card 
(designated by symb) of th' f rs*. card to be 
deleted. If n is zero, the card identified by 
symb will be the first to be dented. 
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Format 
LOCSEO mode 



Parameters 
LOCSEQ mode 



total (OPTIONAL) - The number (decimal) of cards to 
be deleted, or TO END to delete all card* from 
where the program is positioned, up to but not 
including the END card of the program being 
revised. If total is omitted, ons card will be 
deleted. 



L 


Location 


Command 


■■ "■ ■ — % 

Address and Remarks | 






DELETE 


xxxxxxxx, total 



xxxxxxxx - The eight -character Identity and Sequence 
field of the first card to be deleted. 



total (OPTIONAL) - See DELETE, LOCFLAD mode 



Action 



The TACL program designated by the most recent 
CORRECT instruction is copied card-by-card onto the 
output tape until the specified card is encountered. 



Remarks 



The specified card (first card to be deleted* plus all 
subsequent consecutive cards as determined by total 
are bypassed on the input tape. The input tape is 
positioned at the card following the last one bypassed, 

If TO END is specified as total, ail cards of the pro- 
gram being revised, from the specified card up to but 
not including the END card, will be bypassed (deleted). 
The input tape will then be positioned at the END card, 

1. If symb is blank or zero, cards will be deleted 
starting with the nth card beyond the last one re- 
ferenced in a previous ADD, DELETE or REPLACE 
instruction for this program. If there were no such 
previous instructions, cards will be deleted be- 
ginning with the nth card of the program. 

2. If symb and n are both zero, the current location 
on the input tape is assumed. 

3. An END card of a program being revised cannot 
be deleted. 



ia_Ao 



rr* a oejwtfV 



DELETE Example 
LOCFLAD mode 



Assume that the third and fourth instructions are to be 
deleted in LOCFLAD mode from the following coding. 



Location 


Command 

CA 


Address and Remarks 


TEST 






SLAO 


6 




TOD 






JMP 


OUT 




TMD 


W/00000001 




JAED 


(P) + 2H 




AM 


ZEBRA 




JMP 


START 



The following TACSERV instruction is used to delete 
the two instructions. 

L Location Command Address and Remarks 



DELETE 



TEST, 2, 2 



Execution of the TACSERV instruction DELETE causes 
the preceding portion of the program, from either its 
beginning or point of last change, up to but not including 
the TOD instruction, to be written on the output tape. 
At this point, the TOD instruction and the one immedi- 
ately following it are bypassed on the input tape and the 
tape is positioned at the TMD W/00000001 card. 

The corrected portion of the program on the output tape 
now appears as: 



Location Command 



Address and Remarks 



TEST 



CA 
SLAO 



The card TMD W/00000001 and those following remain 
on the input tape and are available for further processing, 



ENDPROG 
Format 



Terminates individual program correction. 



L 


Location 


Command 


Address and Remarks 






ENDPROG 
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Parameter! 
Action 



Remarks 



LOCFLAD 



Format 



Parameters 

Action 



Remarks 



LOCSEQ 



Format 



None 



• The balance of the program being corrected, from 
the point at which the tape is currently positioned, 
is copied onto the output tape. 

• The input tape is positioned at the beginning of 
the block following the last block of the program 
just processed. 

• TACSERV is set to NOSEQ mode, and reset to 
accept Class 1 instruction. 

An ENDPROG card must always be used to terminate 
the correction of a program. 

Sets the TACSERV routine to find cards by symbolic 
address for subsequent ADD, DELADD, DELETE, and 
REPLACE control instructions. 



Location 



Command 



LOCFLAD 



Address and Remarks 



None 



• There is no immediate action. All subsequent card 
searching within the current CORRECT instruction 
phase is set to use symbolic addresses in the 
Location field. 

1. TACSERV is automatically set to the LOCFLAD 
mode of operation whenever a CORRECT Instruc- 
tion is executed, 

2. The LOCFLAD mode Is terminatpH h^ tK« «. v ^^ nt , n „ 
of a LOCSEO instruction, 

Sets the TACSERV routine to find cards by Identity and 
Sequence number for subsequent ADD, DELADD 
DELETE, and REPLACE control instructions. 



L 



Location 



Command 



LOCSEQ 



Address and Remarks 



RIGHT 
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Pa: 



ten RIGHT- (OPTIONAL) - Specifies that the sequencing and locating of 
sards by identity and sequence numbers will be done on the rignt- 
hand side of cards, columns 73 thru PO. If RIGHT is omitted, 
card searching and sequencing will be performed on the left-hand 
side of the cards, columns 1 through B, 

Action There is no immediate action. All subsequent card searching within 
the current CORRECT instruction ohase will be performed according 
to the above parameter specifications. 

REMARKS 1. If RIGHT is specified subsequent LOCFLAD, LOCSEQ, or SEQ instructions 
will not terminate right-hand side sequencing. Right-hand sequencing 
can only be terminated by the execution of NOSEQ or ENDPROG instructs 

2. The LOCSEQ mode of card-searching is terminated by the execution of a 
LOCFLAD or ENDPROG instruction. 



NOSEQ 



Format 

Parameter! 
Action 



Terminates assignment of new sequence numbers to 
cards of a TACL program being corrected. (Assign- 
ment of sequence numbers is initiated by the SEQ con- 
trol instruction). 



L 


Location 


Command 


Address and Remarks 






NOSEQ 





None 



There is no immediate action. When NOSEQ is 
executed, all cards written on the output tape from 
this point forward will he transferred with their 
Identity and Sequence field unaltered. 



REPLACE 



Format 

LOCFLAD 

mode 



Replaces one or more cards in the TACL program. 
REPLACE operates either in LOCFLAD or LOCSEQ 
mode. 



L 


Location 


Command 


Address and Remarks 






REPLACE 


symb, n, total 



Parameters 

LOCFLAD 

mode 



symb - The symbolic location used in conjunction with 
ri of the first card to be replaced. 

ji - The number (decimal) of cards past the card 

(designated by symb ) of the first card to be re- 
placed. If n is zero, the card identified by symb 
will be the first to be replaced. 



total (OPTIONAL) - The number (decimal) of consecutive 
cards to be replaced. If total is omitted, one card 

will hp rpnlarpH 
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TACSERV 



Format 

LOCSEQ 

mode 



Parameters 
LOCSEQ mode 



Action 



L 


■Location 


Command 


Address and Remarks 






REPLACE 


xxxxxxxx, total 



xxxxxxxx - The eight-character Identity aad Sequence 
field of the first card to be replaced. 

total (OPTIONAL) - The number (decimal) of consecutive 
cards to be replaced. If total is omitted, one card 
will be replaced. 

• The TACL program specified by the most recent 
CORRECT instruction is copied card-by-card onto 
the output tape untii the specified card is en- 
countered. 



Remarks 



REPLACE Example 
LOCFLAD mode 



• The specified card plus subsequent cards as a f er- 
mined by total are replaced. Their corresponding 
replacement cards (following the REPLACE instruc- 
tion; are writter. onto the output tape The input 
tape Is positioned at the card following the last one 
replaced. 

1. If symb is blank or zero, cards will be replaced 
starting u^ith the nth card beyond the last one 
referenced in a prf-vious ADD, DELATE, or RE- 
PLACE instruct lor. fur this program. If there 
were no previous such instructions, cards will be 
replaced beginning with 'he nth card of the program. 

2 if svmb ar:ci L are bcth zero, the current location 
or, the input tape .6 assumed 

3„ ihe REPLACE function v„: be terminated whenever 
ar. END c^rd is processed. An END card may be 
used to repiace any other card, but an END card 
must not be replaced by another card, 

Assume that the third and fourth instructions are to be 
replaced in LOCFLAD mode in th»- following coding, 

L_ Location Command Address and Remark* 



TEST 



TMD 
JAED 

CA 



W/00000001 

(P) + 2H 
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TACSERV 



REPLACE 


L 


Location 


Comm 


and 


Address and J 


Remarks 


Example 
LOCFLAD Mode 
(Continued) 






SLAO 

TMQ 
JAEQ 
AM 
JMP 




6 

W/77777777 
(P) + 3H 
ZEBRA 
START 





The following TACSERV instruction is used to replace 
the two instructions. 

L_ Location Command Address and Remarks 

REPLACE TEST, 2.2 



Execution of the TACSERV instruction REPLACE causes 
the preceding portion of the program, from either its 
beginning or point of last change up to but not including, 
the TMQ W/77777777 card (indicated by TEST+2), to 
be written on the output tape. At this point, the TMQ 
W/77777777 card and the one following on the input 
tape are bypassed. The two cards following REPLACE 
are written on the output tape following SLAQ 6. 

The input tape remains positioned at the AM ZEBRA 
card, which is available for further processing. 

The revised portion of the program on the output tape 
now appears as: 



Location Command Address and Remarks 



TEST 



CA 

SLAQ 
TMD 
JAED 



W/00000001 
(P) + 2H 



SEQ 



Sets TACSERV to assign new sequence numbers, be- 
ginning with a designated configuration, to each sub- 
sequent card of a TAG language program being trans- 
ferred to the output tape. 
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TAC8ER/ 



Format 



Parameters 



L 


Location 


Command 


Address and Remarks 






SEQ 


seqno, inc. cols 



seqno (OPTIONAL) - Eight alphanumeric characters to 
be placed in the Identity and Sequence field of the 
next output card of the program being revised. 
The seqno parameter may consist of zero to eight 
alphabetic characters or spaces followed by zero 
to eight decimal characters. The total must be 
eight, representing the eight columns of the Identity 
and Sequence field. (If seqno is omitted, the Identity 
and Sequence field of the first card transferred to 
the output tape will be transferred as the first se- 
quence number. ) see Note; below 



inc (OPTIONAL) - The number (decimal) by which 

seqno is to be incremented from card to card. If 
inc is omitted, an increment of one will be assumed. 

cols (OPTIONAL) - The number (1 through 8) of columns 
of seqno that will be affected by the incrementing 
process. If cols is omitted, four columns will be 
assumed. 



Action 



There is no immediate action. All cards transferred 
to the output tape following execution of the SEQ 
instruction will be sequenced according to the above 
parameter specifications, 



Remarks 



Incrementation numbering is modulo 10 , where 
c is the number of columns to be affected. 



2. Sequencing is terminated by the NOSEQ control in- 
struction or the ENDPROG control instruction. 



Note: 



3. Each of the SEQ parameters may be used independ- 
ently of the others, or may be omitted. 



4. 



If all parameters are omitted, the sequence number 
of the first card transferred to the output tape 
following execution of the SEQ instruction will be 
assumed as the initial sequence number. Subsequent 
cards will be sequenced in Columns 5, 6, 7, and 8 
and incremented by one. 

If sequencing is to occur on the right-hand aide of the cards 
(collars 73 through 80), the SEQ control instruction must be 
preceded by a LOCSEQ irstruction specifying RIGHT in the 
Address and Remarks field. 



Kev. Karch, l%g 
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TACSERV 



If only the first parameter segno is specified, 
seqno will be the sequence number of the first 
card. Subsequent cards will oe sequenced on t^.e 
last four columns and incremented by one. 

If only the first two parameters seqno and inc are 
specified cols will be four, with an increment 
designated by inc. 

If the first parameter Is omitted, but the remain- 
ing two are specified, the Identity and Sequence 
field of the first card will be assumed. 

If the first two parameters are omitted and cols 
is specified, the Identity and Sequence field of the 
first card will be assumed, and subsequent card 
sequence numbers will be incremented by one. 
Columns wiii be affected as indicated by cols . 

If the first and third parameters are omitted and 
only inc is specified, the Identity and Sequence 
field of the first card will be assumed. Incremen- 
tation will be indicated by i:ic and four columns are 
to be affected by the sequent mg process. 



TACSERV 
OUTPUT 



Program 
Listing 



Output from TACSERV may c or.sist of an updated TAC 
language tape and a printed listing ot programs written 
onto the output tape. If a TACSERV" control instruc- 
tion error is detected, the error will be indicated on the 
Console Typewriter ar.d High-Speed Printer, 

If LIST is written as a parameter of the ENDALL con- 
trol instruction, a listing of the ID and block count of 
each program written or. the output tape plus the total 
block count including sentinels, will be edited and placed 
on TSYSOUT. edited for printing on the High-Speed 
Printer. 



Console 
Typewriter 



Whenever an error is detected during operation of the 
TACSERV routine, the following indication is typed 
on the Console Typewriter; 



TACS En 



where _n_ indicates the type of error as described below: 
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TACSERV 



High-Speed 
Printer Error 
Indications 



Error 
Exit 



Detection of an error also causes the following indication 
to be written on the system output tape, edited for print- 
ing on the High-Speed Printer: 



$$$$$$$ 



card contents 



TACSERV Error: Error Statement 



where card contents is the illegal card, and error 
statement is the appropriate error message. 

Following detection and indication of the TACSERV 
error control is transferred to 1ENDJOB. A listing 
of all TACSERV errors follows: 



Type -Out 

TACSE1 
TACSE2 

TACSE3 

TACSE4 

TACSE5 

TACSE6 
TACSE7 

TACSE8 

TACSE9 
TACSE10 

TACSE11 

TACSE12 

TACSE13 



Print -Out 

ILLEGAL CONTROL CARD 

TAPE SPECIFIED IS NEWTAPE OR IS 

A RESERVED SYSTEM TAPE 

NEWTAPE HAS NOT BEEN 

SPECIFIED 

SENTINEL BLOCK PREVENTED 

COMPLETION OF FUNCTION 

END CARD FOUND BEFORE SPECIFIED 

FLAD/SEOUEMCE - NUMBER 

ATTEMPTED DELETION OF END CARD 

MORE THAN 8 CHARACTERS IN 

SENTINEL PARAMETER 

ILLEGAL PARAMETER IN ENDALL 

CARD 

"I" CARD INTERCEPTED 

CARD(S) IGNORED DURING SEARCH 

FOR "ENDPROG" CARD 

ATTEMPTED REPLACEMENT OF AN 

"END" CARD -- NEW CARD NOT "END" 

CARD SPECIFIED BY SYMB PLUS N 

HAS ALREADY BEEN TRANSFERRED 

MORE THAN 8 CHARACTERS IN 

SEQUENCE PARAMETER 



TACSERV 



t a rcrpv 
EXAMPLE 



AoeiimD fK^t ill T>-^/->TT»-3»->-> C On T.M1B O T . O T A f~! T j UT) trt 

but not including program ZEBRA, and all programs 
on Tape ADDTAPE, up to and including program ABLE, 
are to be transferred to Tape NEWTACL. Program 
ABLE is to be revised as it is transferred. 



Location Command 



Address and Remarks 



NEWTAPE 


NEWTACL 


$(D 


REWIND 


OLD! ACL, 
ADDTAPE, 






NEWTACL 


${2) 


COPYTIL 


OLDTACL, ZEBRA 


$(3) 


CORRECT 


ADDTAPE, ABLE 


$(4) 


LOCSEO 




$<5) 


SEO 


ABLE0001, , 3 


$(6) 


ADD 


ABLE0032, 1 


$(7) 


TMA 


CARD 


$(8) 


ENDPROG 




${9) 


ENDALL 


LIST, BBBBBBBB 


$(10) 



Explanation - Execution of these instructions causes 
the following action to take place: 

1. Tape NEWTACL is assigned as the output tape. 

2. Tapes OLDTACL, ADDTAPE, and NEWTACL are 
rewound. 

3. All information prior to program ZEBRA on tape 
OLDTACL is transferred to tape NEWTACL. 

4. All information prior to program ABLE on tape 
ADDTAPE is transferred to tape NEWTACL, and 
TACSERV is set to the Class II mode. 

5. TACSERV is set to search for cards by sequence 
number. 

6. TACSERV is set to assign sequence numbers to 
cards within the corrected program ABLE. 
Sequencing will begin with ABLE00001 and incre- 
mentation will be by one. 

7. The portion of program ABLE prior to card 
ABLE0032 is transferred to tape NEWTACL. 
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TACS£RV 



8. TMA CARD is written on tape NEWTACL. 

9. The remaining portion of program ABLE is trans- 
ferred to tape NEWTACL and tape ADDTAPE is 
positioned at the beginning of the block following 
the last block of program ABLE, TACSERV is 
set to NOSEQ mode, and reset to accept CLASS I 
instructions. 

10, Two sentinel blocks of B's are written on tape 

NEWTACL. A listing of the ID and block count of 
each program written on tape NEWTACL plus 
total block count is written on TSYSOUT and control 
is returned to 32KSYS. 
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TAPEDUMP 



FUNCTION 



SERVICE 
ROUTINE 
INITIATION 



INPUT-OUTPUT 
SYSTEM 

CONTROL 
INSTRUCTIONS 



TAPEDUMP SERVICE ROUTINE 

Edits information from a magnetic tape for printing in 
various formats. 

The TAPEDUMP services routine may be called into 
operation by the following instruction: 



Location 



Command 



TAPEDUMP 



Address and Remarks 



TAPEDUMP uses 32KSYS XORD for all tape move- 
ments . 

TAPEDUMP accepts five control instructions written 
in standard 32KSYS control line format: 

Instruction Function 

PROCESS Processes the designated tape, con- 

verting and editing the data as specified 
and writin™ the output on TSYSOUT, 

REWIND Rewinds one or more tapes. The func- 

tion is as described in Tape Handling. 

SPACEF Spaces forward on the designated tape. 

SPACEB Spaces backward on the designated tape. 

ENDALL Terminates the action of the TAPEDUMP 

routine and returns control to 32.KSYS. 



PROCESS 
Format 



Parameters 



L 


Location 


Command 


Address and Remarks 






PROCESS 
PROCESS 


t, n, f 
t, sent, f 



_t - The symbolic tape except TSYSDMP, TSYSOUT, 
and TSYSIN, to be processed. 

n - The number (decimal) of blocks to be processed. 
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TAPEDUMP 



sent - the sentinel word to be used in locating a sentinel 
block. 

_f - Analphabetic character that specifies the format in 
which the tape is to be edited. 

A = Alphanumeric 
H = Hexadecimal 

O = Octal 

F = Floating-point 

nS = Fixed-point, where 11 is a decimal 
number from through 47, which 
indicates the position of the binary 
point. If ii is omitted, will be 
assumed. 



SPACEF 
Format 



Parameters 
Remarks 



Location 



Command 



SPACEF 
SPACEF 



Address and Remarks 



t ji 
t, sent 



See PRuuESS 

If sent is specified, the tape will be positioned immedi- 
ately following the sentinel block. 



SPACEB 
Format 



Parameters 
Remarks 



Location 



Command 



SPACEB 
SPACEB 



Address and Remarks 



I'll 
sent 



See PROCESS 

If sent is specified, the tape will be positioned immedi- 
ately following the sera ii el block (in reference to a 
backward direction). 
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TAPEDUMP 



PMT>4 T T. 



Format 



Location 



Command 



ENDALL 



Address and Remarks 



Parameters 
Action 



None 

TAPEDUMP is terminated and control is returned via 
SYS. 1NXTCON 
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SECTION XV 
APPLICATIONS 



This section deals with applications whirh 
run under control of the 32KSYS monitor. 
Information relevant to use of the application 
system within the monitor is Included; de- 
tailed information as to the input and output 
formats, options, etc., can be found in the 
documents referenced by each application. 
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PERT 



PERT - Performance Evaluation and Review Technique 



FUNCTION 



Initialize* a PERT run. 



FORMAT 



PARAMETERS 



L 


Location 


Command 


Address and Remarks 




run 


PERT III 


±1 • *2 ' £ 



run - Signifies an initial run or an update run to an 

existing Master File. One of the following two para- 
meters must be written in the location field: 



• INITIAL - an initial run 

• UPDATE - an update run to an existing Master File. 

t_i (OPTIONAL) - The symbolic tape indicating the 

existing Master File. If not present, run must be 
INITIAL. 



ACTION 



REFERENCE 



t - The symbolic tape indicating the new Master File. 

n_ - The number (decimal) of tape transports available 

to PERT III. If n_is unspecified or is greater than 10, 
PERT III will utilize up to eleven tape transports. If 
n = 10 and an old master file tape is specified, PERT 
III will rewind TSYSCR7 to provide a transport on 
which to mount a file tape. If n is less than ten an 
error typeout will ensue and the run will be term! - 
nated. 

• The input deck is read, sorted, and merged (if 
an UPDATE run) with the existing Master File to 
create a new Master File tape. 

• PERT computations are performed. 

• Output reports are generated. 

The program is described in TM-30, Philco 2000 PERT 
III System. 
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PERT 



REMARKS 



1. If a PERT III run is successfully completed, the 

program return* to the system via SYS. 1NXTCON. 
Otherwise, control is returned via SYS. 1ERRDMP. 



CONSOLE 
TYPEWRITER 
NORMAL 
TYPE- OUTS 



Message 



PERT III 



Explanation 



Start of run 



MASTER FILE Location of new 
ON T XX Master File 



CONSOLE 
TYPEWRITER 
ERROR 
TYPE -OUTS 



Message 
DUMPPERT 



TOO MANY 
PREDECES- 
SORS OR 
SUCCESSORS 



Explanation 

Machine or pro- 
gram error, 
Computer halts. 



Input data error 



Action 

Dump memory 
and contact 
Philco Program- 
ming R it D 
Dept. 

None. Returns 
toSYS.lERRDMP 



BAD CONTROL Illegal or missing 
CARD parameter(s) in 

PERT III control 

card. 



None. Returns 
to SYS. 1ERRDMP 
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STAT/2000 



STAT/2000 



FUNCTION 
FORMAT 



Initiates a STAT/2000 run 



PARAMETERS 



REMARKS 



REFERENCE 



T- 



L ! Location Command ! Address and Remarks 

1 i 1 



i 



STAT 



t| (S), t 2 (S) 



♦. - The symbolic tape to be used for storage of data 
~' values. If omitted, TSYSCR3 is assigned to tj . 

t 2 - The symbolic tape to be used for storage of data 
~ results. If omitted, TSYSCR6 is assigned tojf ^ • 

(S) (OPTIONAL) - Indicates that _t | and/orJ 2 is to be 
rewound with lockout. This allows the tapes to be saved 
for future use on NODATA or FOLLOW option. 
(Refer to Philco Manual TM-36.) 

The STAT/2000 System is loaded into core. 

Tko innut Aarlr U r«ni-i nnd thf> rf>auf>«tf>rl statistical 
..... ... r ~. .. — , 

function is performed. 

Both printer and plotter output are placed on tape 
TSYSOUT. 

Subsequent statistical functions are loaded and executed 
until an ENDSTAT control card is encountered. 

t | and t « ore handled as specified by the STAT card, i.e., 
they are rewound with lockout if (S) has been requested. 

The use of (S) eliminates the ability to stack runs. When additional 
statistical functions are desired, the STAT control instruction must 
be resubmitted releasing tapes t_j and _t 2 • 

STAT/2000 control cards, individual statistical programs, and console 
typewriter typeouts are described in the Philco Manual TM-36. 
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XMAS 



XMAS - Expandable Machine Accounting System 



FUNCTION 



Initiates an XMAS run. 



FORMAT 



L 


Location 


Command 


Address and Remarks 






XMAS 





PARAMETERS 



None 



ACTION 



Loads the XMAS Monitor program and transfers 
control to it. 



The XMAS Monitor then reads the parameter 
cards following the XMAS control instruction 
and calls on the XMAS programs required for 
calculating, collating, report writing, selecting 
or sorting 80 character card records. 



REFERENCE 



The status of XMAS tapes, the programming language, 
and console typewriter typeouts are described by TM-28, 
Philco 2000 XMAS System Manual. 
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LP 



LP - Linear Programming 



FUNCTION 



nivi3,v€S ctn ±-ixr 3*\in» 



FORMAT 



L 


Location 


Command 


Address and Remarks 






LP 





ACTION 



REMARKS 



1. 

2. 



LP reads the input data and subsequent control 
cards following the LP control instruction. 

LP computations are performed. 

Printer output is placed on tape TSYSOUT. 

TSYSCRO is used as the scratch for History Tape. 

If an LP run is successfully completed, the pro- 
gram returns to the system via SYS. 1NXTCON. 
Otherwise, control is returned via SYS. 1ERRDMP. 



REFERENCE 



The program is described in TM-7, Philco 2000 Linear 
Programming System. 
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SECTION XVI 
TAC LIBRARY ROUTINES 



Associated with 32KSYS are several sub- 
routines and generators available for place- 
ment on the TAC library tape (TSYSLIB). 
These subroutines and generators have 
application only within programs run under 
control of 32KSYS. 

32KSYS generators such as SNAPGEN and 
LOADGEN, provide at compilation time 
machine language for specific 32KSYS func- 
tions . 

32KSYS generators are called into operation 
usxng the call word in the Command field and 
the parameters in the Address and Remarks 
iield. 
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LOADGEN 



LOADGEN - Loading Generator 



FUNCTION 



Generates machine coding at compilation time, which, 
when executed, causes a program to be loaded via the 
internal loader. LOADGEN enables a program to be 
loaded during the running of another program. 



FORMAT 



Location 



Command 



LOADRPL 

or 
LOADABS 



Address and Remarks 



n, id, go $ 



PARAMETERS 



LOADRPL - Indicates that a normal RPL program is 
to be loaded. 

LOADABS - Indicates that an ABS program is to be 
loaded. 



TU« T3TTM Irlprimal 

lliv • - - ■ - ■••-------—-- 



ACTION 



REMARKS 



id 



C! throuffh 15). of the tape from 
which the program is to be loaded. It may also be 
the symbolic location of a word which contains the 
PUN in bit positions 18 through 23. 

The identity of the program to be loaded. 



go (OPTIONAL) - If GO is written, control will be 

~~ transferred to the program just loaded. If omitted, 

control will be returned to the calling program after 

program id has been loaded. 

During compilation of the objec' program, TAC re- 
places the programmer's LOADGEN call with a trans- 
fer of control to the coding generated by LOADGEN. 

1. After a program is loaded via LOADGEN, control 
may be transferred to it, or be returned to the 
original program. 

2. Each error condition that is detected by LOADGEN 
will generate: 

a. Coding that includes a JMP SYS. 1ERRDMP 

instruction, causing an automatic error 
dump at run time. 



it.-? 



LOADGEN 



b. A comment card, which defines the error 
condition. This card will not have an 
asterisk in column 9, therefore causing 
compilation error. 

c. The comment card THE REMAINING 
CHARACTERS IN THIS CALL ARE ...... 

followed by a comment card(s) with the 
remaining characters of the call. 

3. The 32KSYS internal loader may also be used at 

run time by a transfer of control to SYS. 1INTLD. 



EXAMPLE l Location Command Address and Remarks 

LOADRPL 6.SEGI, GO$ 

Explanation: Execution of this instruction causes coding 
to be generated at compilation time, that will load pro- 
gram SEG1, located on PUN 6, into memory at run time 
in RPL format. Control is transferred to SEG1 im- 
mediately after it is loaded. The tape on PUN6 remains 
positioned at the end of 5EG1. 



lb- 3 



SNAPGEN 



SNAPGEN - Snapshot Generator 



FUNCTION 



Generates machine coding at compilation time, which, 
when executed, produces selective snapshot dumps 
during the running of an object program whenever 
designated conditions are met. SNAPGEN produces 
the same snapshot dumps as those produced by the 
SNAP control instruction. 



CALL WORDS 



The SNAPGEN generator may be called either by a 
SNAP or a SNAPTOG call word. SNAP requests a 
dump whenever specified conditions are met; SNAPTOG 
indicates that the snapshot dump is to take place (depend- 
ing upon conditions) only if a designated toggle switch is 
in the ON position during the running of a program. 



SNAP FORMAT 



L 


Location 


Command 


Address and Remarks 






SNAP 


format; start:end;cond$ 



SNAPTOG 
FORMAT 



L 


Location 


Command 


Address and Remarks 






SNAPTOG 


tog:format: start;end;cond$ 



PARAMETERS 



All parameters must be separated by semicolons. 



tog (for SNAPTOG only) - The number (decimal, through 
47), which indicates the toggle switch that must be in 
the ON position before this particular snapshot dump 
can occur. The parameter may also be a symbol 
defined by an ASGN or SAME card at compilation 
time as a decimal number, through 47. 

format - See format parameter of SNAP control instruc- 
tion. 

start - An absolute or symbolic location which indicates 
the first word to be dumped. Any numeric designa- 
tion is assumed to be decimal. Any configuration 
preceded by an M/ is assumed to be octal. 
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SNAPGEN 



ACTION 



en d - An absolute or symbolic location which indicate* 
the last word to be dumped. The same rules for 
start pertain to end . 

cond (OPTIONAL) - See cond parameter of SNAP control 
instruction. If cond is specified, all numbers are 
assumed to be decimal. M/ designations may only 
be used within parenthesized expressions. A dollar 
sign ($) must follow cond . If cond is omitted, the 
dump is assumed to be unconditional, and a dollar 
sign ($) must follow the end parameter. 

During compilation of the object program, TAC replaces 
the programmer's SNAPGEN call with coding generated 
by SNAPGEN. Included in this coding is a snap table 
which contains the information required to perform the 
snapshot dump, and the call upon the snapshot routine. 



REMARKS 



1. SNAP generator calls may not be placed under 
the influence of an RPT, TIO, or SKC instruc- 
tion. 



2. Upon execution of the generated coding, the contents 
of the JA Register are not saved. 

3. There is not limit to the number of calls within a 
particular program. If an error is detected by 
SNAPGEN during compilation, coding will be 
generated, which will enable each call containing 
an error to be bypassed at run time. For each 
snap error detected, the error condition will be 
printed on the Code -Edit, along with the statement. 
THE REMAINING CHARACTERS IN THIS CALL 
ARE xx. ,.x, where the x's indicate the remaining 
characters, if any, in the Address and Remarks 
field. 



EXAMPLE 



Location Command Address and Remarks 



TMA 


2052$ 


TMD 


2047$ 


JAED 


FINIS$ 


SNAP 


A;1094;JOE;5/9$ 



1A. 

a \s 



SKAPGEN 



L Location Command Address and Remarks 

TMA XRAY$ 

AMS GEORGE$ 

SNAPTOG 1;C;START, 1X;START, 
3X;A<3210$ 



Explanation: The SNAP call causes an alphanumeric 
snapshot dump of decimal location 1094 to memory 
location JOE the fifth through the ninth time the SNAP 
call is encountered. The SNAPTOG call causes a com- 
mand dump of memory location START plus the con- 
tents of Index Register 1 through memory location 
START plus the contents of Index Register 3, if Toggle 
Switch 1 is set to the ON position and if the contents 
of the A Register are less than 3210. 
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APPENDIX A 
32KSYS OPERATING PROCEDURES 



INITIALIZATION In order to initialize the Philco 32KSYS Operating 

of 32KSYS System, 32KSYS, the operator should perform the 

following operations: 

1. For ease of operation, plug the logical and 
physical tape units one-to-one. 

2. Mount the System Tape on Tape Transport 1 and 
a scratch tape on Tape Transport 2. 

Magtape Image Mode: 

a. Set all toggles off. 

b. Read one block from Tape 1 into 
Memory Location Zero. 

c. Execute a JMPL Zero. 

d. 32KSYS (DATE OF VERSION) is typed on 
the Console Typewriter. 

e. 32KSYS will proceed automatically. 
Magtape Code Mode: 

a. Set Toggle 47 on. 

b. Read one block from Tape 1 into 
Memory Location Zero. 

c. Execute a JMPL Zero. 

d. SET TOGGLES is typed on the Console 
Typewriter and the computer stalls. 



A-l 



e. Set Toggle 21 on. 

f. Set Toggle 47 off. 

g. The white light signal of the Console Type- 
writer comes on and the computer stalls. 

h. Set Toggle 21 off. 

i. Type in normal 32KSYS format: 

CONIN CODE 

Console Typewriter 

a. Set Toggle 47 on. 

b. Read one block from Tape 1 into Memory 
Location Zero. 

c. Execute a JMPL Zero. 

writer and the computer stalls. 

e. Set Toggle 21 on. 

f. Set Toggle 47 off. 

g. The white light signal of the Console Type- 
writer comes on and the computer stalls. 

h. 32KSYS is now set to accept all input via 
the Console Typewriter (Refer to Special 
Operator Actions, Toggle 21; also refer 
to CONTROL LINE FUNCTIONS, Control 
Line Format.) 

Remarks: If a 32KSYS or Service Routine 

control line error occurs while 
in Console Typewriter Mode, the 
operator must clear error condi- 
tions by typing a JOB control in- 
struction before continuing the 
function. 
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EXECUTION OF 
A CLOBDUMP 



In order to execute a 32KSYS catastrophic dump 
(CLOBDMP), assuming Magtape Code Mode, the 
operator should perform the following actions: 

1 . Rewind Tape 1 . 

2. Write one block from Memory Location Zero 
onto scratch tape on Tape Transport 2. 

Do not rewind Tape Transport 2. 

3. Read one block from Tape 1 into Memory 
Location Zero. 



TAPE 
ASSIGNMENTS 



4. Set Toggle 24 on. 

5. Execute a JMPL Zero. 

6. CLOBDMP is typed on the Console Typewriter 
and a clobdump is executed. 

Two tapes must be assigned specific tape units; the 
System Tape on TT1 and a scratch (for use as the 
intermediate dump tape) on TT2. All other tapes may 
be mounted on any available transport and, as each 
is required, the typeout TAPE XXXXXXX = occurs, 
and the computer stalls in a tight loop. At this time, 
the position of the toggle (0-15) which corresponds 
to the IOP plug number associated with TAPE XXXXXXX 
must be changed. The Console Typewriter then types 
the plug number and a question mark, and the computer 
stalls again. If this is the correct plug number, the 
toggle should be returned to its original position. The 
Console Typewriter again types the plug number and 
the System will continue operation. If the plug number 
is incorrect, change the position of another toggle 
(0-15) and repeat the above procedure. 



STANDARD 
SYSTEM 
TAPE 
REQUESTS 



TYPE -OUT 

TSYSCRO 

TSYSCR3 

TSYSCR4 

TSYSCR6 

TSYSLIB 

TSYSIN 

TSYSOUT 



TAPE REQUESTED 

System scratch (write -enabled) 

System scratch (write -enabled) 

System scratch (write -enabled) 

System scratch (write -enabled) 

System library 

System input 

System output (write -enabled) 
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ERROR 
TOGGLES 



viner tape names, as required, win oe notea on me 
JOB request form. 

The Error Toggles are examined every time a JMPL 1 
is executed. If an Error Toggle is set, a message iB 
typed on the Console Typewriter and written on TSY5- 
OUT. Toggle 46 is examined; if it is not set, dumps 
and/or snaps are edited for printing, A search is 
then made for the next JOB instruction unless Toggle 
47 is set (refer to Special Operator Actions below). 



ERROR TOGGLE 



MEANING 



45 
44 
43 

42 
41 
40 
39 



Unexpected halt 
Program in loop 
Deficient operating instruc- 
tions 

Time limit for run exceeded 
Tape error 
Machine error 
Job arbitrarily stopped 



SPECIAL 

OPERATOR 

ACTIONS 



Inhibit dumps /snaps toggle: Toggle 46. 

Before each JOB control card is executed and each time 
a JMPL 1 is executed, Toggle 47 (the Action Toggle) is 
examined. If it is on, SET TOGGLES is typed on the 
Console Typewriter and the computer stalls until the 
toggle is turned off. Then toggles 16 to 23 are examined 
and the appropriate action is taken by the System. 



TOGGLE 



ACTION 



23 



Tapes specified by toggles 0-15 
are freed and nn FREE is typed 
on the Console Typewriter for 
each tape released. 



21 



32KSYS is set to accept all input 
via the Console Typewriter until 
toggle 21 is set off or until a 
CONIN IMAGE or CONIN CODE 
instruction is encountered. 



Whenever control instructions 
are entered from the Console 
Typewriter, a carriage return 
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TOGGLE ACTION 

character must end each instruc- 
tion line. If a typing error should 
occur, the entire instruction may 
be re-entered by pressing the 
STOP CODE Key. In response 
to this action 32KSYS issues a 
carriage return and requests a 
new type -in via the white light 
signal. 

Refer to Remarks under Console 
Typewriter mode. 

i0 WRAPOUT is typed on the Con- 

sole Typewriter and TSYSOUT 
is wrapped-up„ 

*9 RERUN is typed on the Console 

Typewriter and the curtfif <ob 
is rerun. 

18 WRAPIN is typed on the r.->rsole 

Typewriter and TSYSIN in 
wrapped-up, 

17 System searches backwards for 

JOB card and types the job ID on 
the Console Typewriter. 



16 



System searches forward for 
JOB card and types the job ID on 
the Console Typewriter. 



REMARKS If toggle 16 or 17 is used, it must remain set until the 

desired job is encountered. 

JOB ENDINPUT When JOB ENDINPUT is typed on the Console Type- 

writer and the computer halts. The operator must 
select one of the above-mentioned actions (e.g. , wrap- 
up TSYSIN, wrapup TSYSOUT, etc.), by setting 
TOGGLE 47 and executing a JMPL 1 . 
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APPENDIX B 
ALPHABETICAL LISTING OF CONSOLE TYPEWRITER TYPE- OUTS 



Type -Out 



1DMPTAC 



Error/Normal Source 



2DMPTAC 



32KSYS 
mmddyy 

AIDE El 

AIDE E2 
AIDE E3 

AIDE E4 



Error 



Error 



Normal 

Error 

Error 
Error 

Error 



TAC 



TAC 



32KSYS 

AIDE 

AIDE 
AIDE 

AIDE 



ANAL El 


Error 


ANALYZER 


ANAL E2 


Error 


ANALYZER 


ANAL E3 


Error 


ANALYZER 


ANAL E4 


Error 


ANALYZER 


ANAL E5 


Error 


ANALYZER 


ANAL E6 


Error 


ANALYZER 


ANAL E7 


Error 


ANALYZER 



Explanation 

Either a machine or a program 
error was detected during the 
first pass of TAC. A CLOBDMP 
should be taken. 

Either a machine or a program 
error was detected during the 
second pass of TAC. A CLOBDMP 
should be taken. 

The system was just initialized. 
The type -out indicates the sys- 
tem version. 

An illegal control card was de- 
tected. 

A parameter is missing. 

A begin-tape error was detected; 
no sentinel was found. 

More than eight characters were 
specified in the sentinel para- 
meter. 

An illegal control card was de- 
tected. 

The tape specified is reserved by 
the system. 

Parameters are missing. 

The specified format is not ABS 
or RPL. 

An illegal RPL section word was 
detected. 

An illegal ABS card was detected. 
A checksum error was detected. 
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Type-Out Error/Normal Source 



Explanation 



ANAL E8 Error 

nn ASSIGNED Normal 
TO symb 



ANALYZER The end parameter was less than 
the begin parameter. 

32KSYS Logical unit rm is assigned to 

symbolic tape symb . (The com- 
puter will stall until the operator 
selects another unit). 



symb BAD Error 

LIB 

nnnn BLKS Normal 



TAC 



TAC 



Information found on tape symb 
is not library data. 

nnnn blocks were produced in the 
compiled RPL program. 



CLOBDMP Normal 



32KSYS The catastrophic dump is being 

executed. 



CLOCK Error 

FAILURE 



32KSYS 



A clock order was not accepted. 



CMPERRS £rror 



J.AC One or more serious compila.tiun 

FORTRAN errors were detected. 



CONTROL Error 

CARD 
ERROR 



PERT 



An illegal card for PERT run 
was detected. 



nnnn CARDS Normal 



TAC 

OPAL 

FORTRAN 



nnnn cards were generated. 



DATA El Error 



DATA 



An illegal control card was de- 
tected. 



DATA E2 Error 



DATA 



The tape specified is reserved by 
the system. 



DATA E3 Error 



DATA 



An illegal format parameter was 
detected. 



DATA E4 Error 



DATA 



The input is not image as speci- 
fied. 



Type-Out Error/ Normal Source 



Explanation 



DATA E5 Error 



DATA E6 Error 



DATA E7 Error 



DUMPPERT Error 



EALTAC 



Error 



ECOBOL 



Error 



ENDCOMP Normal 

EREPORT Error 



F4DUMP 



Error 



DATA 



DATA 



DATA 



DATA E8 


Error 


DATA 


DATA E9 


Error 


DATA 


DIFFER- 


Normal 


AIDE 


ENCES 







PERT 



ALTAC 



COBOL 



FORTRAN 



REPORT 
GENER- 
ATOR 

FORTRAN 



The number of word* per card wai 
not specified or is illegal. 

The number of cards per block was 
not specified or is illegal. 

The (number of words per card) x 
(cards per block) is illegal. 

More than eight characters are 
specified in a parameter. 

A parameter is not numeric. 

The comparison of two magnetic 
tapes is complete and inequalities 
were detected. 

Either <=. machine or a program 
error was detected during PERT. 
A CLOBDMP should be taken. 

A source language error has been 
detected that would cause gener- 
ation of an incorrect object pro- 
gram. Control was transferred 
to SYS. 1COMPER. 

A source language error has been 
detected that would cause gener- 
ation of an incorrect object pro- 
gram. Control was transferred 
to SYS. 1COMPER. 

Compilation is complete without 
serious error. 

A source language error has been 
detected. Control was trans- 
ferred to SYS. 1COMPER. 

Machine or compiler error. 
Computer halts. Press advance 
to wrap up compilation. 
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Type -Out 



Error/Normal Source 



Explanation 



GENERR 



ID IS id 



Error 



Normal 



TAC 



The generator is requesting more 
parameters than were supplied. 



TAC The identification of a compiled 

OPAL program is id. 

FORTRAN 



ID IS id Normal 

nn CARDS 



WRTABS An ABS program of the designated 

ID, containing nn cards has been 
written on TSYSOUT. 



INSUFFI- 
CIENT 
MEMORY 



Error 



OPAL 



OPAL requires more memory. 



JOB id 



Normal 



32KSYS The system has recognized a JOB 

card, id is the first 16 characters 
of the Address and Remarks field 
of the JOB card. 



LIBE1 




Error 


to 






LIBE47 






mm-dd 




Normal 


hh-mm. 


t 





symb NO 
LIB 



Error 



PLUM 



SYS 



TAC 



For exaplanation of these PLUM 
errors see PLUM description in 
Service Routines. 

A JOB card or CLOCK instruction 
was executed, mm = month; 
dd = day; hh = hour; mm = minute; 
t = tenth of minute. 

Tape symb is not a library tape. 



NO LIB 



NO IDEN- 
TITY 



OPAL 
ERROR 

OPER 39 



Error 



Error 



Error 



Error 



COBOL A COBOL library required by the 

source program is not mounted on 
the correct tape. 

FORTRAN First non-blank card did not con- 
tain program ID. Compilation 
continues in normal manner. 

OPAL Machine or compiler error was 

detected. 

32KSYS The job was arbitrarily stopped; 

the operator dumped the job. 



B-4 



Type -Out Error/ Normal Source 



Explanation 



OPER 40 



OPER 41 



OPER 42 



OPER 43 



OPER 44 



OPER 45 



PERT III 



Error 



Error 



Error 



Error 



Error 



Error 



Normal 



PROGRAM Normal 

TAPE IS t 



32KSYS Machine trouble occurred and 

the operator dumped the job. 

32KSYS Tape trouble occurred and the 

operator dumped the job. 

32KSYS The time limit for the run was 

exceeded, the operator dumped 
job. 

32KSYS Deficient operating instructions; 

the operator dumped the job. 

32KSYS The program was in a loop; 

operator dumped the job. 

32KSYS An unexpected halt occurred; the 

operator dumped the job. 

PERT Start of PERT run. 

OPAL The object program tape is t. 



REINIT 



RERUN 



Error 



Normal 



RPLC El Error 

RPLC E2 Error 

RPLC E3 Error 

RPLC E4 Error 

RPLC E5 Error 



32KSYS 

32KSYS 

RPLC 

RPLC 

RPLC 
RPLC 

RPLC 



The system was not read into 
memory and must be reinitialized. 

The current JOB is to be rerun 
by operator choice. 

An illegal control card was 
detected. 

The tape specified is NEWTAPE 
or reserved bv svstem. 



y j 



NEWTAPE was not specified. 

A sentinel block prevented the 
completion of the function. 

The card following the IDCHANGE 
control is not an I card. 
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Typ«-Out Error/Normal Source 



Explanation 



RPLC E6 Error 



RPLC E7 Error 



RPLC E8 Error 



RPLC E9 Error 



RPLC E10 Error 



RPLC Ell Error 



RPLC 

RPLC 

RPLC 

RPLC 

RPLC 
RPLC 



An illegal section word was de- 
tected. 

An illegal correction card was 
detected and the card was ignored. 

More than eight characters were 
specified in the sentinel parameter. 

The id is missing on the addition 
or correction of an ABS deck. 

A checksum error was detected. 

An illegal control card was de- 
tected. 



RPLC E12 Error 



RPLC 



An illegal parameter was de- 
tected in the ENDALL card. 



SEARCH Error 

NEXT 
JOB VIA 
TOGGLES 



SET Normal 

TOGGLES 



SYSE1 

SYSE2 
SYSE3 

SYSE4 

SYSE5 
SYSE6 



Error 

Error 
Error 

Error 

Error 
Error 



32KSYS The system cannot find the next 

job. The operator should find 
the next JOB via the Search toggle 
(Refer to Special Operator 
Actions. ). 

32KSYS The action toggle was set by the 

operator (action is specified by 
toggles 16-23. ). 

32KSYS The program is not on the speci- 

fied tape . 

32KSYS A Checksum error was detected. 

32KSYS The program origin is in list 

area. 

32KSYS The program origin is in common 

area. 

32KSYS Undefined refout(s) are specified. 

32KSYS An illegal card was detected. 
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Type -Out 



Error/Normal Source 



Explanation 



SYSE7 



SYSE8 



Error 



Error 



32KSYS There was an overflow in the 

symbol list. 

32KSYS An illegal section word was de- 

tected. 



SYSE9 


Error 


32KSYS 


SYSE10 


Error 


32KSYS 


SYSE11 


Error 


32KSYS 


SYSE12 


Error 


32KSYS 


SYSE13 


Error 


32KSYS 


SYSE14 


Error 


32KSYS 


SYSE15 


Error 


32KSYS 


SYSE16 


Error 


32KSYS 


SYSE17 


Error 


32KSYS 


SYSE18 


Error 


32KSYS 


SYSE19 


Error 


32KSYS 



SYSE20 

SYSE21 
SYSE22 



Error 

Error 
Error 



32KSYS 

32KSYS 
32KSYS 



An illegal tape name was specified. 

The tape name was previously 
defined. 

An illegal address parameter 
was specified. 

An illegal pun was specified. 

Too many parameters were 
specified. 

There was an overflow in the 
PUN table. 

A job card was intercepted. 

An unaccountable machine or 
system error was detected. 

An illegal 32KSYS control instruc- 
tion was detected. 

An illegal mnemonic was specified. 

An illegal decimal number was 
specified. 

An illegal position for the binary 
point was specified. 

Parameter(s) are missing. 

Specified symbol is not in the 
symbol list. 
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Type -Out Error /Normal Sou 



SYSE23 



Error 



rce 



Explanation 



32KSYS Illegal from-to parameter was 



srtp rl f i &r\ 



SYSE24 



SYSE25 



SYSE26 



SYSE27 



SYSE28 



SYSE29 



SYSE30 



SYSE31 



SYSE32 



SYSE33 



SYSE34 



SYSE35 



SYSE36 



SYSE37 



Error 



Error 



Error 



Error 



Error 



Error 



Error 



Error 



Error 



Error 



Error 



Error 



Error 



Error 



32KSYS The parameter is too long. 

32KSYS The common size exceeds 

memory, 

32KSYS An illegal break character was 

specified. 

32KSYS An illegal magtape parameter 

was specified. 

32KSYS The NAME.FLAD specified is too 

long. 

32KSYS An illegal number of words is to 

be replaced. 

32KSYS An illegal parameter was specified. 

32KSYS TSYSTEM, TSYSIN, and TSYSLIB 

cannot be write-enabled. 

32KSYS An illegal prog tape was specified. 

32KSYS An illegal octal number was 

specified. 

32KSYS Too many blocks were specified 

to be read. 

32KSYS The format for the internal loader 

was not specified. 

32KSYS Reading to the sentinel will exceed 

memory. 

32KSYS No address was specified in 

location field. 



SYSE38 



Error 



32KSYS An illegal format was specified. 
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Type -Out Error/ Normal Source 



Explanation 



SYSE39 



SYSE40 



SYSE41 



SYSE42 



SYSE43 



SYSE44 



SYSE45 



SYSE46 



SYSE47 



;YSE48 



SYSE49 



SYSE50 



SYSE51 



SYSE52 



SYSE53 



SYSE54 



SYSE55 



Error 



Error 



Error 



Error 



Error 



Error 



Error 



Error 



Error 



Error 



Error 



Error 



Error 



.rror 



Error 



Error 



Error 



32KSYS The new common block length 

exceeds the old, 

32KSYS The program origin equals zero. 

32KSYS Illegal use of TSYSIN if 32KSYS 

is in Magtape mode, 

32KSYS An illegal START-END parameter 

was specified. 

32KSYS The third parameter is not (MAS- 

TER). 

32KSYS The master program is not defined. 

32KSYS The segment area is empty. 

32KSYS A symbol defined more than once 

was referenced. 

32KSYS A referenced symbol was re- 

defined. 

32KSYS It is illegal to locate on TSYSIN. 

32KSYS The relative CSA exceeds PMAX. 

32KSYS LIB must be used if SUBS or 

NOSUBS specified. 

32KSYS An illegal library tape was 

specified. 

32KSYS More than 7 library tapes were 

specified. 

32KSYS Parameter(s) were specified 

more than once. 

32KSYS A reference was made to an 

undefined common block. 

32KSYS There was an overflow in the tape 

name table. 
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Error/Normal Source 



SYSE56 


Error 


32KSYS 


SYSE57 


Error 


32KSYS 


SYSE58 


Error 


32KSYS 


TABOVER 


Error 


ALTAC3X 


TACS El 


Error 


TACSERV 


TACS E2 


Error 


TACSERV 


TACS E3 


Error 


TACSERV 


TACS E4 


Error 


TACSERV 


TACS E5 


Error 


TACSERV 



Explanation 

Parameter n is illegal. 
Parameter n is missing. 

Illegal CSA while loading. 

There was overflow in the TAC 
symbol table. Compilation ends. 

An illegal control card was de- 
tected. 

The tape specified is NEWTAPE 
or is a reserved System tape. 

NEWTAPE has not been specified. 

A sentinel block prevented com- 
pletion of a function. 

An END card was found before 
the specified FLAD/ sequence 
number. 



TACS E6 


Error 


TACS E7 


Error 


TACS E8 


Error 


TACS E9 


Error 


TACS E10 


Error 


TACS Ell 


Error 



TACSERV Deletion of an END card was 
attempted. 

TACSERV More than 8 characters were 

specified in a sentinel parameter, 

TACSERV An illegal parameter was specified 
in the ENDALL CARD. 

TACSERV AN "I" card was intercepted. 

TACSERV Card(s) ignored during search 
for "ENDPROG" card. 

TACSERV Replacement of an "END" card 
was attempted -- new card not 

"END", 



TACS E12 



Error 



TACSERV The card specified by symb + n 
has already been transferred. 
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Type -Out Error/Normal Source 



Explanation 



TACSE13 Error 



TACSERV More than eight characters were 
specified in the sequence para- 
meter. 



symb TAPE Error 
nn IN 
LOCAL 



32KSYS Unit is mechanically unavailable. 

XORD Place tape in remote and press 

advance. 



symb TAPE Error 
nn 

WRTNABL 



32KSYS Unit should be write enabled. 

XORD Write enable the tape and press 

advance. 



symb TAPE Error 
nn 
ROCKED 



symb TAPE Error 
nn 
ILL.WRT 



symb TAPE Error 
nn 
PROGERR 



symb TAPE Error 
nn 
SYSERR 

symb TAPE Error 
nn DIS- 
ABLED 



symb TAPE 
nn BEG 
TAPE 



Error 



symb TAPE Error 
nn END 
TAPE 



32KSYS XORD has made repeated un- 

XORD successful attempts to fix parity 

and/or sprocket errors. Press 
advance to retry, or dump job.* 

32KSYS XORD has been told to write on a 

XORD tape that has not been write - 

enabled, and should not be used 
as an output tape. Dump job. 

32KSYS XORD has received, from the 

XORD calling program, an improper 

parameter. Dump job. 

32KSYS XORD has been partially 

XORD clobbered, or hardware problem. 

Dump job. 

32KSYS Unit became mechanically dis- 

XORD abled while executing an order. 

Dump job. * 

32KSYS XORD has been told to process a 

XORD block prior to the first block on 

tape. Dump job. 

32KSYS XORD has been told to process 

XORD a block after the last-block on 

tape. Dump job. 



* If serious tape error occurs during compilation, see Remark 2 under TAG. 
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Type -Out 



Error/Normal Source 



symb TAPE 


Error 


32KSYS 


nn 




XORD 


SI ERROR 






symb TAPE 


Error 


32KSYS 


nn 




XORD 


S2 ERROR 






symb TAPE 


Error 


32KSYS 


nn 




XORD 


BAD FIX 






symb TAPE 


Error 


32KSYS 


nn 




XORD 


FAULTY 






TOO MANY 


Error 


PERT 


PREDEC- 






ESSORS 






OR SUC- 






CESSORS 






id TOTAL 


Normal 


FLID 


BLOCKS 






nn 






TOTAL 


Normal 


AIDE 


BLOCKS 






COPIES 






nnnn 






INCLUDING 






A SENTINEL 




of xxxxxxxx 






WRAPIN 


Normal 


32KSYS 


WRAPOUT 


Normal 


32KSYS 



Explanation * 

A begin block mark has been 
missed. Dump job. * 



An end block mark has been 
missed. Dump job. * 



A serious error has occurred 
while XORD was trying to fix 
parity and/or sprocket errors. 
Dump job. 

Some combination of faults has 
occurred or there is hardware 
problems. Dump job. 

An error was detected in the 
input data. 



ID of a program and the number 
of blocks in that program. 



nnnn blocks were copied to 
sentinel xxxxxxxx 



The wrapup function for tape 
TSYSIN was executed. 

The wrapup function for tape 
TSYSOUT was executed. 



* If serious tspe error occurs during compilation, see Remskk 2 under TAC. 
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